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From the Editor 


■ M V elcome to Octolier MacTecli! While tliis is my first “I'Yom the liditor,” I want to 
mm mm keep it sliort and sweet. It’s absolutely a plestsore to be working more closely 
with everyone at the magazine. Particularly the authors! There are .some 
incredible [Xiople writing, and more that arc submitting proposals for consideration. 

Equally important are tlie faithful readers! Thank you for years of renewals, and llianli 
you for writing in yourselv&s. If you have ideas, question.s or comments, please do not 
hesitate to write in! lliis is how we tune the magazine to your needs. You can send your 
comments to lelters®mactech.com. 

'ihLs montli showcases articles that will impact your everyday routine. OS X Server presents 
a compelling system for any small business. It’s easy to get a website up and running using the 
tools supplied. However, when the hiLsincss giows, and the website expands, you may notice 
that tlie site isn't quite as .snsippy as it used lo be. Frequent coniriluilors Emmanuel Stein, Jin Lin, 
and Jamie Ferri show us how to tune your web server tor performance. 

You may liave heard of tlie Mac OS X Enterprise Project (macenlerprise.org)? Co-chair 
Philip Rinehart follows up his excellent Automator article with a piece on CUPS - the 
printing system in OS X. WeVe gotten many requests for more information on CUPS, and 
Philip's article is sure to satisfy! 

It’s your dream; you’re charged with transitioning a department or company from 
Windows to an all-Mac environment. However, there arc roadbltx:ks. Paul Animann is also 
hack with a topic that most of us encounter at one point or another; transferring mail from 
Outlook to Entourage. 

Of course, wc have ourotlrer regular features lo keep you up-to-date and in-Uie-know. One 
even covers both the Rails and AJAX phenomenon! Enjoy, and rememl'ier to write in! 

- Edward Marezak, Executive Editor 
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ApplbSchipt Essentials 


by Benjamin S. Waldie 

Introduction 
to Scripting 

QuarkXPress 

___ / 

My Iasi two columns have focuseci on using AppleScript to 
aut<imatc graphic processing with Pliotosiiop and 
GniphicConveiter. I'his month, we are going to switch gears 
from graphic processing to discuss another commonly 
automated creative pnxiess - desktop pnldishing. Specifically, 
we will explore some initial ^steps necessary for automating a 
desktop publishing workflow using QuarkXPress, a popular 
page layout application. 

History 

QuarkXPress was one of the first applications to support 
AppleScript, with version .12. [n lad, it is l>elieved l.iy some that 
QuarkXPre.ss is actually panially responsible Ibr AppleScript 
l>eing around today. Kviiuor has it that, at one time, Apple had 
|)lanncd to do away with AppleScript, but received such a 
backlash from the publishing community, who threatened to 
move to PCs if their scripted workflows were taken away, that it 
was decided to keep AppleScripl around. 



Figure T. QuarkXPress 7's New kon 

One great aspect of Quark's Aj^pleScripi su[i[>ori is its 
commitment to backward-compatibility. Prom the early tbys to 
uxby Willi version 7, see figure 1, Quark’s AppIeSt ript support 
has rn>l changed all iJiat much New terniinoltigy has Ixren added 
for new appliaition features. However, existing terminology has 
stayed relatively the same^ with only minor moclifications along 
the way. This fias allowed many users to upgrade llieir .scripts for 
new^ versions of Quark without tlie hassle of making a large 


number of adjustments. In fact, the recent jump from Quark 6 - 
7 introduced only a handful of changes to existing AppleScripl 
temiinology, allowing many Quark 6 scripts to function in Quark 
7 without any changes whatsoever. 

Getting Started 

As you begin scripting Quark, be sure rcj refer to Quark’s 
AppleScript dictionary regularly to determine the proper 
terminology to use. (See figure 2.) You will find that Quark's 
dictionary is broken into a number of logical suites of classes 
and commands, and that Quark’s canlainmcnt hierarchy is 
fairly straightforward. 



For Quark 6.x users, I higlily recommend downloading and 
iiistalltng an updated copy of tlie SctipLxrU Xfension. 'Ihis updated 
XTenslon will fix prot^lems that may occur when piinting Quark 
ckxiimenis to PusuScripi format in Mac OS X 10.^ and liigiKT. Tliis 
Xlension is |:ra!t of a paclaige named Oitipul linf:fancenmiis 
Xlemlom sq/huam (mer mode) for QtiatisXFfvss and QuarkXPress 
PassjH)ri 6.5. Tills package Is available for download fmm liie 
Support > Desktop DoumkMsds .secdon of Quark's website at 
<http://vvvvw.quarkxom/service/desktop/downloads/cletai!5.jsp?idx=601>. 

Getting to Know Quark Projects 

In QuarkXPress, the document in which you will work is 
known as a prolect, and a project contains one or more layout 
spaces. For example, a project amkl contain a print layout, a 
web layout, and more. Prior to Quark 6, layout spaces did not 
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exist, nor ciid projects. At that time, a document was simply 
called a docuincmt. 

As far as AppleScTipl is concerned, Quark’s AppieScripl 
terminology contains project, layout space, and 
document classes. The document class exists to allow for 
compatibility with scripLs written for older versions of Quark. 
When referring to a project in Quark, you do so as follows: 

tell appii^ration "QuarkXPress" 
tell project 1 
— Do sometl^ing 
end tell 
end tell 

The code alx>ve would refer to the fronlmosL projecl. The 
following code demonstrates how you would address a layout 
Space within rhai project. In this case, the first layout space is 
being addressed. Even if the project only has one layout space, 
you must still address the layout. 

tell application "QuarkXPress" 
tell layout space I of project 1 
^ Do something 
end tell 
end tell 

As menlioned before, Quark also supports a class of 
document, which you may use if you ch(:x)se to. For example: 

tell application "QuarkXPrees" 
tell document 1 
— Do something 
end tell 
end tall 

Referring to a doeumenl in this manner is essentially the 
same as referring to the cuiTeni layout space of a project. In this 
example, dcxiiment 1 refers to the frontmost project document. 

In the examples above, I referred to projem, layout spaces, 
and documents by iheir index, or front to back ordering. Of 
course, you jnay also refer to projects, layout spaces, and 
d(X'umenLs by their names, if desired. For example: 

tell application "QuarkXFreas" 

tell layout space "Layout 1" of project "‘Project!" 

- Do something 
end tell 
end tell 

Creating a Project 

To create a new project with a single layout space in 
QuarkXFress, use the make command, die result of which will 
be a reference to the newly created project. For example: 

tell application "QuarkXPress" 
make new project at beginning 
end tell 

“> project "Projectl" of application "QuarkXPress" 

In Quark, layout splices within the same project c:an be 
different sizes. In the code above, we did not specily a height 
and width for the layout space in the newly created project. 
Because of this, Quark’s current default size settings will be used 
to create the project. However, these can be adjasted by 
modifying the page height and page width properties of 


the default document class, prior to creating die project. For 
example, the following code would create a projea containing a 
layout space that is 6 inches high and 8 inches wide. 

tell application "QuarkXPress" 
tell default document 1 
set page height to "fi in" 
set page width to "8 in" 
end tell 

make new project at beginning 
end tell 

> project "Pcojectl" of application "QuarkXPress'^ 

The layout space class itself also lias page height and page 
width properties, wiiich can be modified after the project is 
erreated, if desired. For example, the following code would 
create a new project witii a single layout space lliat is 4 inches 
high by 4 inches wide. 

tell application "QuarkXPres.s;" 

set theProject to make new project at beginning 
tell layout apace 1 of theProject 
set page height to "4 In" 
set page width to "4 in" 
end tail 
end tell 

Creating a New Layout Space 

'fhe make command may also be used to create a new 
layout space within an existing project. In doing so, you may 
choase to specify profierties of the layout space, such as page 
height and page widtii. F’or example: 

tell application "QuarkXPtesB" 
tell project 1 

make new layout space at end with properties ipage 
height:'* 11 in", page width:"8.S in"! 

end tell 
end tell 

Working with Text 

Creating a Text Box 

A key aspect of scripting Quark involves working with text. 
In Quark, text is placed into text boxes on pages within layout 
space.s. To create a text box via AppleScript, you will need to 
detertnine where you would like the text box to be created, and 
how large ycju would like it to be. 

First, deiemiine the page on which the text box should be 
created. Next, determine wliere you would like tlie box to l>e 
po.$itioned on that page, and how large it should Hits 
infomialion will lie communicated ro Quark using a list of 
bounds. Tliis list will be formatted as follows: 

I top position, loft positlnu. bottom position, right 
posiLionI 

Now, to create the text lx>x, use tlie make command, and 
specify the Ixiimds for the box as follows: 

tell application "QuarkXPress" 

tell page 1 of layout space 1 of project t 

make new text box at beginning with properties 
[bounds:I"i in", “1 in", "3 in", "6 in"11 
end tell 
end tell 

-> text box 1 of page 1 of layout space "Layout 1” of 
project "Project1" of application "QuarkXPress" 
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Using ihe code ;i[^>ve, j text Ixjx would ix‘ created on page 
1 of die layout spate. The top left comer of the Ixjx would he 
one inch down, and one inch from the left side of the page. The 
bottoin right Cf)rner of the box would be 3 inche-S down, and 6 
int:hes from the left side of the page. Therefore^ this text box 
would Ixf 2 inches high and 3 inches across. 

Placing Text 

In Quark, a sU)ry represenLs all of tlie text within a text box. 
Once a text liox exists, yon rruiy set its text to a specified string 
by setting the value of its story element. For example: 

tfill application ‘"Q.natkXPress" 

tell page 1 of layout apace 1 of project 1 

set story 1 of text box 1 to “My Project Text" 
end tell 
end tell 

Please note that the code alx>ve would replace exLsting text 
in the box, if present. 

Styling Text 

Stories possess numerous text properties, wtiich are 
modifiable via AppleScript. 1 will cover only a few of these in 
this column. I encourage you to explore Quark’s AppleScript 
dictionary for a complete list of these properties. Please note 
that many of diese are found under tlie text properties and 
character properties classes, which are inherited by the 
story class. 


Tlic: following example ctxle demonstrates the modification of 
a number of different diaracter properties within a story, including 
foot, size, and color. As you can see, values for these 
properties may be applied to the story itself, such as tn the case of 
the font property below. Or, valuers may Ix^ applied to elements 
of the stojy, such as si^ecific paragraphs, words, or characters, 

tell application "QuarkXPress'' 

tP-11 page 1 of layout space L of project 1 
tell story 1 of text box 1 
set font to "Ariai" 
set size of word 2 to 24 
set color of word 1 to “Yellow" 

set color of word 2 to “Cyan" 

set color of word 3 to “Magenta" 

end tell 
end tell 
end tell 


I'igure 3 shows an example of a text box containing text 
that was styled using the exainple code above. 



Working with Pictures 

Creating a Picture Box 

As you will find, working with picture boxes in Quark is very 
similar to wtirking with text Ixixes. To create a picture lx>x. use 
the make ccxiitmind, and specify a value for the lx:>x’s bounds 
prtiperty. Again, the bouncLs of the b<.)x will indtcvite its size and 
jxisiLioning on the sfxicified |iage. Tlie following example code 
will aeute a 3 inch high by S inch wide picture box. 

toll application "QuarkXPress:" 

te^ll page 1 of layout space 1 of project ] 

mke picture box at heginning with properties 
Iboiirids: l“3 in", “1 in", “6 in", "6 hril 
end tell 
end tell 

picture box 1 of page 1 of layout space "Layout 1" of 
project “Projectl" of application “QuarkXPress" 

Placing a Picture 

Once you have tTealed a picture box, you will probably 
w'ant to place a picture within it. To do this, ,set its image to a 
specified file path. For example: 

set thelmage to choose file with prompt “please select an 
image to place:" without invisibles 
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tell application "QuarkXPress'* 

tell page 1 of layout apace 1 of project 1 
tell picture box 1 

set image I to thelmage 
eod tell 
end tell 
end tell 

Figure 4 demonsirale.s a pictore lx>x in Quark ihai has Ix'cri 
popiilaicd wiili an image file using die example code above. 



Figure 4. A Placed Picture 


Naming Boxes 

In most of the examples so far, we have referred to text and 
picture boxes by therr index^ t.e. front lo back ordering on the 
page. The problem with writing a script in this miinner is that 
the ordering of the Ixixes on a page may change if lK>xes are 
added, groupech or deleted. 

To get around this limitation, and ensure that your script is 
always interacting with the correct boxes, it is good practice to 
assign names to boxes in your Quark dcKuments. Just as 
projecLs, layout spaces, and dcKuinenis can lie referred to by 
najiic, text and piaure boxes can also be referred lo by name. 
Itie problem, however, Is that Quark does not provide an 
interface for naming text and piaure boxes. Therefore, this 
must by done using AppleScript, by modifying the name 
property of the desired box. For example: 

tell application “QuarkXPresa" 

tell page 1 of layout space 1 of project 1 
tel] text box I 

set haaie to “Photo Description" 
end tell 
end tell 
end tell 


Once a name has l>een assigned to a lx)x, you can use iLs 
name, raiiier than its index, lo refer to the box. For example: 


tell application "QuarkXPtess’* 

tell page 1 of layout .^pace I of project 1 

set text of text box “F^holo Description" to "Photo 
Description" 
end tell 
end tell 
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Next Steps and Resources 

Documentation and Examples 

[f you are a serious QuarkXPress user, and you are planning 
to muke yourself more efficient by introducing AppleScript 
automation into your workflow, there are several ways to get 
started. First, be sure to view Quark's Guide to Apple Emnts 
Scriptififf dtKumcntation, This is installed along with 
QuarkXPress, and can be found in the Documents > Apple 
Ihmm Scripting folder in the main QuarkXPress folder. 

Also, in ihc Appie Ewnts Scripting folder, you will find a 
sample Construction AppleScript file, whieli ct>ntains 

some example code to get you sUirted. This script is unlocked 
and editable tor you to modify, or to borrow code for insertion 
into your own scripts. 

If youTe interested in finding even more dtKumentation on 
scripting QuarkXPress, you may want to check out X^Ray 
Magazine at <http://WWW.xraymag,COm/>, X-Ray Ls geared 
entirely for Quark users, and {exciLse the shameless plug), in 
addition to writing for MacTech, I also write a regular 
AppleScript column for X-Ray on,., you gueSsSed it, 
AppleScripting QuarkXPres.s. 

If the above resources still can't contain your quest for more 
QuarkXPress AppleScrijri knowledge, then you should check 
out AppleScripting QtmrkXFfess, by Shirley Hopkins, whitb is 
available (although in shon supply) from Amazon.com at 
<http://www.amazon.eom/gp/product/0970726S03/>. 


When your customers 
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Expanding QuarkXPress" AppleScript Support 

Inevitably, you rniiy encoLmter things that you wish were 
scriptable in Quark, but iinfortiinniely, simply are not. Well* 
before you get uk> upsei, you may want to ciieck around to see 
if there is a tliird-party Xfension that will add the functionality 
that you need. Quark's XTension architecture allows developers 
to create their XTensions tiiat actually add new^ AppleScript 
termimjlogy to Quark's dictionary. One such developer is Em 
Software {http://www.emsofTwarexom), whose Xcatalog and 
Xdim XTensitms are scripiablc, and can allow users to automate 
c]uilc complex document construction workflows. Gluon 
(http://www.glLion,com) is another developer that offers a 
number of scriptable XTensions lor QuarkXl^ress. 

Recording AppleScript Cxxle in QuarkXPress 

The dream of anyone gening slatted on scripting 
QuarkXPress, is k> be al)lc to record tasks they perform 
manually using the Script Editor's record functionality. 
Unfortunately, QuarkXPres.s (like mrjst applications) does not 
support AppleScript recordability. To get around this 
limitation, however, be sure to check out ScripiMasierXT, a 
commercial XT'ension for QuarkXPress, availal>!e from Jintek, 
LLC (http://www.jtntek.com/). Script MasterXT adds 
AppleScript recordability, as well as numerous tiseful 
AppleScript commands, 10 QuarkXPress. A limited 
demonstration version of Seri pi MasterXT Ls available for 
dtjvvnload from the Jinlek website. 

In Closing 

We liavc really only scratched the .surface of scripting 
QuarkXl^ress. Tliere are many, many more tasks that can be 
automated in Quark using Ap[)leScript, and I would encourage 
you to continiie exploring them on your own. With a little work, 
it's easily poSvSibfe to automaie even lire most complex Quark- 
based workflows iLsing AppleScript. 

Until next time, keep scripting! 

'/ill 
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A Non-Developers Introduction to CVS 


By Jose R.C. Cruz 


Introduction 

When working on a c:ompulcT-based yjroject, you often rely 
on stjme form of version conlrol system to keep track of all work 
and changes made to your project files. Such a system allows 
you to create oftkial archives of your project and provide you 
with an Isolaicd local copy that you can work on. It also allows 
you and oilier participants to coordinate your ctintribuiions to 
die project. 

'Ihis article will inmniutc^ you to the Irasic conc'ept of version 
control using the open-source Xool CVS. lliis tool is preinstalled in 
all versions of MacOS X, and is accessed via the Temiinal application 
located in the /Applicatians/Utilities direclory. 

The Concurrent Versioning System 

What is CVS? 

The Concurrent Versions System (CVS) is an open-source 
software tool that provides centralized version control on 
IK)SlX-cotTipaiil>ie systetns. It is originally developed from an 
earlier versioning system call the Kevision Camirol System (RCS)* 
which can manage changes, made to individual hies, but not to 
whole projects. 

The source code to CVS was released for public disirihuiion 
in June 1986. An improved version of tlie ttxjl was released on 
April 1989 under ihe GNU Ihiblic License. The version of CVS 
that comc-s installed in MacOS X b version LIO (for OS X 10.3*9), 
and version 1,11.18 (for OS X 10*4). 

Advantages and disadvantages of CVS 

One ntgable advantage of CVS is that it is available for a 
wide variety of operating .sy.siems. It is also one of the few 
version control system.s that behave conststendy across 
(dalforms. For example, CVS can store and maintain iLs pnijecl 
archives on a linux server, while providing kxal copies of its 
archives for MacOS X and Windows Xl^ users. 

Another advantage of CVS is that it works indepcTidenlly of 
your projecl environment. For instance, you can use CVS to 
maintain archives of your XCcxle project as well as your Adol>e 
Go Live web f)ages. Some might find this lack of tight integnuitm 
to !xj a hindrance however. But, if your project environment is 
scripiable, you can always use your favorite scripting tool to 
integrate CVS with your environment. 

Finally, CVS is mucli more foigiving than most commercial 
packages. In fact, tliese commercial packages use c.roncepts and 
prcx'erlums similar to that of CVS. Once you have mastered 


using CVS, your learning curve would he less steep, when you 
upgrade to a commercial and more sc]phisiic:ated system* 

The biggest tiisadvantage of CVS is that it is originally 
designed to manage text files, Ils support for binary file formats 
is rudimentary at Ixrsl* Files such as spread,shecLs, JPEGs, etc*, 
are often stored in their entirety, causing the project archive to 
slowly grow to unmanageable sizes. However, this limitation is 
not uniciue tt> CVS. Many commercial packages provide limited 
suf jpurt, if any at all, for binary files. 

Another di.sadvanUtge is that CVS is designed to handle 
ASCII lexl files, h has problems dealing with UnIccKle and non- 
ASCII files. However, this limitation is being addre.ssed in the 
open-source tool, Subversion, which is iK'ing developed as a 
potential successor lo CVS. 

Yet anotlier (tiiough minor) disad%^antage of CVS Ls tJiat it is 
.still primiuily a command-line rcxjl. If you are more cromfortahle 
working with a poini-andH::lic:k systeni, there are a number of free 
anti open-source solutions that provides a graphit'al iLser interface 
lo CVS. A notable eximiple is the MaeCVSClient X application, 
which Is wTitten by J* Bullmann, and availal>ie at tile UllL: 

<http://www.heliancoo.nel/MacC:vsclient> 

Preparing the Repository 

The eVSROOT environment variable 

lieftjre using CVS, you Rn>t have to .set the CVSR(X)T 
environment varialile. 'Itifs is used to storo tlie default location of 
the CVS repository* Tliis article a*ssuiiies that you are using bash 
yf>ur .shell environment. Ytai can find our whit h sliell ytm are 
using by launching the 'ferminal application and typing 
print env SHELL at the command prompt. If you are not using 
bash, type man <^sh 0 ll_name> at the crjiumand prompt for 
iiLsiruaiuns on liow to configure your own shell environment. 

First you need lo tTcale the shell startup file, 
,bash_profiln in the rtKrt of your home directory. Use your 
favorite text editor to create this hidden file. Some 
recommended editors are BBHdil, Smuliron, emacs, and the 
venerable vl. in.sen the Ibllowing script at the beginning of the 
file and then restart the Teimiiial application. 

? Start of CVS canflguration 
eVSROOT - /Uecrs/Shared/Projects 
export eVSROOT 
il^**end of CVS configuration 
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'I'his script tells CVS to store its rep<isitory in 
/Users/Shared/Projects. Every CVS command thereafter 
will affetn the project archives stored at this location. 

You cdn alwys assign your own direaory path for your CVS 
repository. Alternatively, you can override tlie default loctilion by 
using tite -d global option whenever you type a CVS rainmand. 

Creating and configuring the repository 

After selling the CVSROOT variable, type CV3 ‘init to 
initialize llie repcxsitory. Once successful, CVS will create a 
directory named CVSROOT at lire location S|m'ified by its 
environinenl variable. It will alst> pO[>ulate the directory with a 
numlx*r t)f files (Table ITahle ITable 1) iliat are used to configure 
Uie repositoiy, 

Among?ii lliese files, the cvswrappers file is the one ihii idls 
CVS how to siort* aich pn^ject file. By deliiult, CVS will cirnven the 
line ending diaraclers 
fixind in eich file to a Rle 

fonn appn>prialc for 
ihe hast system. It will 
also attempt to 
expand any keywords 
tliat it finds in each 
file. 1 lowever, these 
lx*haviors cun cx)mjf)l 
a puwiy binary file. . 

As created, 

cvswrappers contains 
only minmenLs. 

Take a kx>k at tlie all¬ 
text cvs-wrappers to 
customize it for your needs. You need to update tlie cvswrapper 
file il' you plan to store biruiry files in your project aa^hive. If, for 
example, you want to inciude JPEG and GIF files to yxxir archive, 
add the following lines to the file. 

*.jpg k "b* Jii 'COPV 

-.gif k m -con* 

lliese will tell CVS to store these binary files in their entirety. 

Adding a project 

You should now have a working CVS repository, lb add ytnir 
project to the repository, navigate to the location of your pn>jecl 
cliretiory by typing cd €project_directory_location> at 
tlie Terminal ]irompt. Then use the import command to add 
your website project to the repository. 

CVS import -m “tshort descrlptioD of your project>’'"* 
<3rcMve_naine» <tueer_naine> «release_tag3^ 

Note: fThat entire command fine is typed as a sin^tfie line. 
The -< t:hara<iLT is iherc‘ only to indicate die continuation of the 
line. 

For example, tf your website project directory is in 
/ Volumes/Users /myilomc/ Si tesnsy S11, le 


type cd /Volumes/Users/tnyHome/Sites at the Terminal 
prompt. ITien use the import t:ominanti It) add your website 
pmjetn to the rep<xsitory. 

CVS import m ‘‘Cfikpri doscriptiDu of your projrtcti'*”* 
€arGhive_iiaBie> <iiiser_oamo> <^elease_rag)^ 

Ntite that entire command line is typed as a single line, llie -> 
character is there only to indicate the continuation of the fine. 

So using the alx)ve example, you would Then, arcliive your 
wellsite project by typing 

CVS import m ^'My website project** ■■ 

“ inySlte Sitae ttyNatne version 1 0 

at the prompt. 

CVS will then generate a series of messages as it parses 
each and every file and suhdirectory in your project 

directory, as while 
Descfipikiii creating il creates 

the project archive. 
When sticcessfyl, 
your proiccl will be 
stored in the same 
directory as 

CVSROOT under 
« a r c h i V e„naiiie> 
(Figure I Figure 
1 Figure 1). 

However, ilf you 
decided not to 
continue with this 
archive, use the 
Finder to navigate to the directory where CVSROOT is stored. 
Then delcie the «archive_naiDe» directory by dragging it 
to the Trash and choosing Empty Trash from the Finder 
menu. 



Figure 1. Structure of a CVS repository. 


coiifig conngune ocnajn global parametre^ 

modules (kfine aliases and altemaie groupings for project archives, 

cominulnfo. loginfo. rcsinfo custamise various pans of ibe commiial process 

verifymsg verify ilie tog message used in the commiial process. 

taginfo customise the lugging process 

cvs\KTdppers specify how each project Hie is to be storcd in the archive 

Table 1. List of common CVSROOT files. 
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Working with the CVS Project 

The CVS version number 

CVS uses iin interriiil version number system to keep track 
of which project file has l^een iiiodified or Ijranched. In its tjasic 
form, a CVS version number consists of at lettst two fields of the 
non-zero pc^sitive number, wirli each field delimited by a peritxi 
(ASCII 0x2 g). The formal assumed by the version number is 

« p ro j e c imbe . < rev ini on„au mb e r >[.«b ra n ch^numb e r > J 

CVS incremenLs the €revision_numfoer» field each Lime you 
checked in a modified file back into the arcliive. However, when 
you create a branch off a specific file, CVS adds a 
^branch_nuinber> for ihat branch. It then updates the field 
c^acli lime you cliecked in a nicxlified version of that branclted 
file. Additional «:branch_nuinber> fields are also added 
whenever ymi append new branches to that same file. 

The ^proj^ct_ninnber» field remains mostly unchanged 
throughout the project. In fact, you must avoid interfering with 
the internal version system to prevent any orphan files or 
Immches. If you warn to as^sign your own version number to the 
projeci archive, use tJie evs tag command, which will be 
covered later on. 

Checking out a prefect or file 

Now that you have a project archive in the CVS 
repo.sitory, you first have to check oiitretrieve a copy of that 
archive for ytm U) work on. You do this by typing evs 
checkout «pro] ect_name^ at the Terminal prompt. 
Alternatively, if you want to check out a specific project file, 
type CVS checkout €project_file_path3‘, where 
^project_fllG_path> is ihe directory path of the file with 
respect to the main project directory. 

CVS will then create a local copy of the project or file on 
your present working direcU>ry. Eacli director>' in diis copy will 
be accompanied by a CVS sulidirectory, which is used to store 
information about your local copy (Figure 3Figure 2Figure 2). 


'‘'Project name*- 



fpfoject syMtrfictOfv* 



projoci 






CVS 






J 




Figure 2. Structure of a checkout CVS project. 


Once you iiave checked out your local copy, your username 
is automLiticiilly added to the CVS log. Otlier people working on the 
same project archive iis you are, will fx* aware of your pi-e.sen<::e. 
So, if you are done with your local copy, type evs release 
«project_naine> at tlie 'lerminal prompt. CVS will first check and 
prompt you, if you have any nicxlificd files in your copy. Once you 
answered YES to the prompt, it will no longer kee]i Hack of your 
copy. U will also remove you from its user log. 

So, using the website example, you would type evs 
checkout Sites, to retrieve a copy of your website project 
from the repository. The project directory, Sites, will then be 
c:reated in your present working directory, and it will contain at 
least one CVS sulxlireclory. Once you are done making changes 
to your website, type evs release Sites to infomi CVS to 
cease keeping track of your loail copy. 

Adding a new file or directory 

Suppase you lia ve created a new file or directory in your local 
txjpy, and you want to add ii to the projea arehive. To do so, type 
CVS add ^new_directory_path> at die Terminal prompt. 
Now unlilre most conuiiands, C^S does not autoinatically execute 
the add command, in.stejid, it queues the acquest into its command 
liufl'cT. This ensures die integrity of your project archive by giving 
you a eliiince to cancel the request. 

If you liave decided to cancel the request to add the new 
file or directory, first move or delete the file or directory from 
your project directory, simply Then, type evs remove 
€Tievi_directory_path> at the Temiinal prompt, 'lliis will tell 
CVS to remove the add request for that file or director)^ from its 
command buffer. 

So, let Li.s assume tliat you have added the file, hello .html, 
to your Sites projea diieaory. To add that file to the projea 
archive, type evs add S ites / h e 11 o. htm 1. To cancel the add 
request, remove die hello.html file from die Sites directory, 
ihen type evs remove Sites/hello. html to remove die 
re{|iicsl from ihe command bufier. 

Updating your copy 

As you work on your local copy, you may want to check 
your copy against die project archive periodically. Since CVS is 
designed fixim the start to support multiple users, otliers may 
have made changes that could impact your own. As you work 
on your local copy, you may want to check your copy against 
the project archive periodically. Naturally, this does not apply if 
you are the only one working on the projea. 

To t:heck your copy against the archive, type evs update 
at the Tenninal (irompl. You can also type evs update - - d. 
to include sulxlirectories that are present in the archive, but not 
in your local copy, 

CVS will tlien scan every Ole in your local copy and 
compare their contents with those in die arcliive. If it comes 
across an unmodified local file older than the one in the archive, 
CVS will attempt to replace that file with the latter. If, however, 
it comes across one that is nuidified, CVS will attempt to merge 
the local file with die one in the archive. It will then inform you 
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of any conflicting changes, should the merge process fail s. It 
will also inform you of any files or directories on your loail copy 
that are newer or non-existent in the f>rojccL arcliive. 

Reverting to a previous version 

WiKit if you have made a mistake when editing one of your 
IcKal files? What if you decided to completely discard your 
changes for whatever reason? You can revert to the previous 
version of a project file by using the cvs update command. 

First you need to know which previous revision of the file 
you want to revert (see the cvs log command later in this 
article). Once you have that established, type 

cv^ update j €iiew - revision tiuinber> “i 

-j -Cold - revision-QumberJ <£ilertame> 

at the Tenninal prompt to start the reversion process. 

CVS will first retrieve both revisions and then perfonii a join 
operation between the two flies. The joined result then replaces 
your local copy. At this point, you can decide if you want U) 
commit your reverted copy back into the project archive. 

Committing your changes 

You liave made clianges to some files on your bail pR)ject. 
You Iwe also added new files and/or subdirectories to your 
project iLS well. After cx inside ruble testing and review on yottr part, 
you are now ready to sli limit yotir changes to die project amliive. 

To do so, type cvs cominit -m "reason for 
committal" nt the Terminal prompt. CVS will then sc:an your 
local project, and update any files in the arciiive with your 
changes. It will also execute any addition or removal requests 
that are queued in the command buffer. However, if you only 
want to update a .single file or .siiklirectory in the project 
archive, type cvs commit -m "reason for committal" 
«file_or_directory_name^ at the prompt. 

Again, let us assume that you have changed the title of your 
hello.html file, and then saved your changes. To commit that 
modified file to the archive, type 

CVS cotmnlr -m ' 

“Changed the title of the hello*html file" 
Sitesyhellci.html 

at the piompt. 

Always make .sure la pmmfe a brief an4 concise rer^son 
whenever each time yon use the cvs comnLit command. Not 
[)roviding a reason for the commiital action is generally frowned 
ii[:ion in normal [>raetice. It compromises tlie change liistory log 
of your project archive as well makes it difficult for you to revert 
to a previous vei'sion. 

Also, always pay aUentiou to the status messages (Listing 
IListing lUsiing 1) displayed by CVS during the commiital prot'ess, 
If CVS encountered any errois, it will immediately stop the committal 
procc'ss after the last sLicx^ssful file or dire<lory upckitc. To preserve 
archival integrity, avoid attempting furthej- committals until you (or 
your project nuinager) has isolated and resolved the error. 

You afst) may want to avoid executing a committal reejuest 
when tlie project archive is l)eing backed li[) oi undergoing 
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maintenance!. Consuit your colleagues for [nlernal rules 
governing the conimittal prtKcss. 

Listing 1- Sample output of the evs coimnit 
conuiiand. 

Checking In Sites/beUoh£?we,btiiil: 

/Users/Shared/Ptoj ects/Sites/helloome.html,v <- 
home,htmhello.html 

new revision: 1.4; previous revision: 1.3 
done 

Reverting to a previous version 

What if you Iiave inadu a mistake when editing one of your 
loc'al files? What if you decided to completely discard your 
changes for whatever reas<m? You can use tiie evs update 
command to revert lo the previous version of your files. 

First, you need to know wliicli previous revision of the file 
you want to revert to (see the gvs log conimand later in this 
article). Once you have that established, remove the file dial 
you want to revert from, and type evs update -r 
«revision_number> <filename> ai tlie Terminal prompt. 
CVS will first warn you that you are missing a file, and then 
promptly ujxlate your ItHial copy with the correct file. 

On the other hand, if you have already committed your 
changes to the archive, type 

eve update -j <new_reviEioii_nuinber» “> 

*j <oid..revislon_nuinbGr» <fileriamei> 


at I he prompt to start the reversion process. CVS will first retrieve 
lx)tli revisions and then perform a join ofjcralion between the 
two files. Tile joined result then repbees your local co[>y. Al this 
point, you can decide if you wani to commit your reverted copy 
hac:k into the project archive. 

Using die website example, if your hello.html file is at 
version 1.4 in the arcliive, but you want to revert to version L3, 
type CVS update -j 1,3 -j 1,3 Sites/helio,htmi to 
revert to the desired version. 

Exporting the project 

Once you (and your coUciigues) liave finiLslied suhmiiting all 
your dianges to the project archive, you should now you arc now 
ready to export a copy of ilic archive for public distril>utiorL TliLs 
axiid mean preparing a software project for firiiil compilation, an 
XML dtx.umenl for printing, or web pages a wel>sitc for uplcxiding. 

First you prepare ihe project archive for exporting, by 
assigning it with a release tag. First, navigate to the project 
directory and iType evs tag at the 

Terminal prompt, where 4:release_tag> would be your 
project’s official version nuinber. Make absolutely sure that no 
one is allowed to perform any cominiltals while you are 
assigning the release tag. Otherwise, the wrong files may get 
tagged in the process. 

Once you have assigned the tag, lypt^ 

cvE export €release_tfl&> 

cexport_deatination> <projecL_atchive» 
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ul the Terminal prompt to export the prujeti to the 
Cexpo tt_d e st inati on3> directory.. 

For example, if you want to export tlie website project, first 
navigate to the Sites directory by typing cd -/Sites at the 
ierminal prompt. Then type cvs tag 1_0GM to assign the 
website with a release lag of 1 * OGM., Finally, type 

CVS export -F vl_0G11 /Volumes/Users/Public Sites 

to export the entire website project to the directory 
/Volumes/Users/Public* 

Make sure that your release tag conUuns only alphanumeric 
chaniciers and/tjr an underscore. Also, make absolutely sure that 
no one is allowed to perform any committals while you are 
assigning the release tag. Otherwise, the wrong files may get 
tagged in the pnK'ess. 

Unitkc Unlike a checked out project, an exported project 
does not contain the CVS subdirectories u,sed to keep track of 
project changes. Any changes made to an exported project wiH 
not l)e committed back into die projec't archive. , 

Fuitliermore, you cannot update an exported project wiUi 
the latest changes from the archive. If you want to get the latest 
changes made to ilie archive, you will have to repe:it the entire 
export prtKedure. 

Strcaxiilinmg the CVS process 

Since CVS is a conumnd-Une tool, you may have noticed that 
using it involve-s a considerable ainouni of typing. You can reduce 
the amount of typing involved by using the aiipropriate a)mmand 
syntmym. Ff>r cxatiiple, instead of cvs checkout to check out a 
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copy of the archive, use cvs get or cvs co. Also, instead of cvs 
update to run m update check, use cvs upd or cvs up. 

You can get a list of other CVS command synonyms by 
typing CVS -help-synonym at the Terminal prompt. 

You can also reduce the amount of tyj>ing by using die 
.cvsrc startup file (Listing 3Listing 21isting 2) to assign die 
default options for each CVS command. Yt>u can use your 
favorite text editor lo create and edit this liidden file in your 
home direciory. Make sure lo restart the Terminal application in 
order for the changes to take effect. 

A typical CVS command line follows the format of 

CVS «giobai_options> <cvE_ccitniEiarid> <comniaiid_optfonc>. 

So each line in the .cvsrc file would be writlen down as 
i^cvs_cotnmand^ «command_options». Note that, if you 
have an entry of cvs «global_optioris» in the file, those 
options apply to all command sessions. You can always 
override these default options by adding a -f option to your 
CVS command. 

For additional information about CVS command options, 
type man cvs at the Terminal prompt. 

Listing 2* Sample contents of the . cvsrc 
startup file. 

CVS -q "/Users/Library/Shared/Project/'* 
c1le^;:kolJt 'd '’WHyProject'' --P 

cotimit -1 
export -f P 

Monitoring a CVS project 

Tracking with sticky tags 

As mentioned earlier, CVS uses an internal version number 
system to keep track of the files ('ontained in your prtjject 
archive. You can then s|x.'cify wljich revision of the file you want 
lo be ufidalcd to liy using the - r comiiiand option. For example, 
typing 

CVS update i.l Sites/homeheii^j.htail 

Updates your local copy of home.html against version 1.1 of 
that same file in the archive. 

A more llexihle approach of keeping track of the archived 
files is throLigh the use of stkky lags. Sticky tags enables you to 
tell CVS which branch or revision of ihe project archive you 
warn lo work on. You can use sticky tags to protect parts of your 
local copy from cha[iges submitteil to the archive. For example, 
you can tell CVS tliar your local copy uses version 1.2 of a 
.specific file even iliough a new version of that file is available. 

To set a sticky tag, tyjx* cvs checkout - r 
< revision number> <project_aame> when checking out a 
copy of the pmjeci archive. Aliernatively, ytju can tyi>e cvs 
update r «revlsion_number> ^project .fil€_path> if 
you want lo perform an u[xJate check at the specified revision. 

You can also use dates as your sticky lag liy using the -B 
command option. The formal used by CVvS for dates is '‘dd minm 
yyyy" where Tnmm is the three-letter month abbreviation. For 
example, typing 
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if Cyour_website_stats == ???) { 
try_visistat = free; 
setup = no_brainer; 
web_stats = i!!; 

} 

else { 

no_clue = true; 

} 

//REAL-TIME WEBSITE TRACKING 
goto = www.visistat.com; 


JC VisiStat, 

Where Clicks Count “ 






CVS update “U Kat 2006 ” 

Sires/styles/da faulthello.html.cs s 

Updates your local copy of defauIt.csshello.html to Uie 
one dated March 15, 2006 in the archive. 

In either case, sticky tags permanently link your lt>c:al t:t>py 
lo that version of the archive. Changes submitted to the arcliive 
will not appear on your UkiiI copy v^henever you perform an 
update check. Also, for integrity reasons, you cannot commit any 
changes you have made until you clear all sticky lags. To do so, 
type CVS update -A at the Tenninal prompt, Make sure to test 
your changes lor errors and possible conflicts l>elbre submitting 
tliem to the aichive, using die cvs cottitnit command. 

Tracking tlie differences 

As you work on your local copy, you may want to check it 
against the project archive periodically for any potential 
conflkls. To display die differences lietween your IcKal copy 
and dtc archive, type cvs diff «project_name3^ at the 
Terminal prompt. Alternatively, if you v^^ani lo display only the 
differences in a specific file, type cvs dlff 
«project_f ilename> instead. 

In either case, CVS will parse your local copy and 
compare iLs contents against the archive. It will then display 
a report (Listing 5Lisling ^Listing 3) showing what has 
changed between the two. By examining this report, you can 
identify any potential ctmflicts between your local copy and 
the archive. 


Listing 3, Sample output of the cvs dif f 
command. 

Index: Sites/styles/default.Cfifihello.htmJ 

RCS file: 

/Users/Shared/Projacts/Sites/styles/default.csatiello.html,v 

retrieving revision 1.2 

dlff -ri,2 defaixlt.csebelio.html 

3c5 

< i^cnntcnts of the archived itvisinn» 

> «eoiitenis of the local revisions 

You can Aim just type cvs update at the prompt to tell 
CVS to go ahead and update your local copy with the archive. 
If the archive contains changes that conflicts witlt your copy, 
CVS will mark those changes using the fonnal shown in Listing 
7Listing ^Listing 4, You then resolve the conflief by manually 
merging the two clianges. Make sure lo consult your colleagues 
for standard procedures on conflicn resolution. 

listing 4* Format used by CVS to mark 
conflicting changes. 

<««« ^filename with coofiicting chan&es> 

fehareges in the local revisions 

tchanges in the archilval revision* 
tarchival_rev 1 ni on_inuinher* 

Tracking with logs 

You can use CVS lo keep inick of the revision state and 
history of your pnrject. The one you prohahly use most often is 
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the CVS status command. 

The CVS status command displays the current state of 
your local copy compared to the archive. It also displays the 
version number of your local files as well as any sticky Lags you 
have assigned U) ihosc files. Tliis coininatid is nonnally used 
[)rior to cvs update, to give you an idea of how the update 
process might afFecI your local c:opy. 

To display die current ,stale of your kxi-al copy, type cvs 
status at the Tcniiinal prompt. If you want to view the status of 
a particular file, type cvs status 4:project_file_path3> a! 
the prompt. In either case, CVS will generate a status log similar 
to the one sliowii in Listing 9listing ^Listing 5- Tliis log shows the 
cLirrent state of each file in your locil copy, its sticky tags, and iis 
CVS version numl^er 

Listing 5. Sample output of the cvs status 
command. 


File; news2002.htinhello.htifll Status: Up-to-date 

Working revision: i.Kl.l Wed Har 1 18:53:53 2006 

depository revision: LI.l.] 

yUsersyShaLed/Prt>jecLs/SiLes/pages/archives/newn2D06.htiiihellQ.h 

tlfll.V 

Sticky Tag: Hkl (revision: 1.1.1.1} 

Sticky Date I (none) 

Sticky Options: (none) 


File; 1gp150.padfooler.html Status; Op to date 


Control real-world devices 
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riety of standard applications 
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* Cocoa 


• Java 
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• LabView 

• DirectorMX 

• 4th Dimension 
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pressure or brightness. Get Custom made models. USB- 
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Working reviaian: 1,1.1.1 Wed Har 1 18:53:53 2006 

Repoeitnry revlelon: 1.1.1.1 

/Users /Shared/Pro jec ts /Si te;3/ page^/ mpad / Igp 150. padf ooter. htmi. v 
Sticky Tag: Mkl (revision: 1.1.1.1) 

Sticky Bate: (none) 

Sticky Options r (none) 

CVS status: Examining Sites/styles 


File: defau1t,cs£i Status: Up^to-date 

Working revision: 1.1,1.1 Wed Mar 1 18:53:53 20d6 

Eepository revision r 1.1.1,1 
/Users/Shared/Projects/Sites/atyles/default. cs±3, v 
Sticky Tag: (none) 

Sticky Date: 2006.03.15,08,00.00 

Sticky Options: (none) 


Another command that you can use is the cvs log 
command, Tliis command allows you to display a revision 
history log of each file in your local copy. Tlie log shows the 
location of the archived file, its current and previous vcrskm 
numlx^rs, and its assigned tags. Also, for eacli revision, the log 
reveals tfie name of ihc u,ser who worked on the file, the 
numl^er of lines added or removed, and a description of wliat 
has lieen changed in that file. Note that, you am only use the 
CVS log command if you have checked out the project from 
the archive. 

To display the revision history of a file in your local copy, 
type CVS log «projeGt_file_path^ at tile Terminal 
prompt. If you want to display the revision history of the entire 
project, type cvs log <projGct_nani6» at the pnimpL CVS 
will then generate a revisitm history log similar to the one shown 
in Lisling 1 IListing (iListing 6. 

Listing 6. Sample output of the cvs log 
command. 

RCS fiJle: /Users/Shared/Projects/Sltes/liello.hlniUv 

Working file: Sit^a/hello.htnil 

head: 1.4 

branch: 

locks; strict 

access list: 

symbolic names; 

vl_0GM: 1.3 

keyword substitut.icn: kv 

total revisions: 4: selected revisions: 4 

description: 


revision 1.4 

date: 2006/04/05 17:55:34: author: kuronke; state: Exp: 
lines: +1 -1 

Updated the body of hello.html 


revision 1.3 

date: 2006/04/04 19:18:45: author: kuronke; state: Exp: 
lines: +1 -1 

Added an entry to the body 


revision 1,2 

date: 2006/04/04 19:17:54: author: kuronke: state: Exp; 
lines: +1 -1 

Added an exclamation point to the title. 


revision 1.1 

date: 2006/04/04 19:03:54: author: kuronke: state: Exp; 
Added the hello.htnil file 


All interfaces ships with a Well suited pre- and after 
complete SDK, drivers, sam- sales eMaihsupport is avail- 
pie apps and documentation, able as a matter of course. 


RCS file: /Users/Shared/Projects/S1 tes/page,-:/booksale.htm,v 
Working file; Sites/pages/booksale*hLm 
head: l.S 


www.bkohg.com/products.htmt 
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branch: 
locks: strict 
access list: 
symbolic names: 

Kkla: 1.5 
Kkl: 1,1.1.1 
anarakis: 1.1.1 
keyword substitution: kv 
toIsI reviaionB: 6: selected revisions: 6 
description: 


revision 1.3 

date: 2006/0J/03 19:34:47; author: user!; state: Ekp; 
lines: il -1 

Removed the conflict data 


revision 1,2 

date: 2006/03/03 19:10:13; author: userl: state: Exp; 
lines: +1 -1 

Removed irrelevant infottnation from the faooksale pa^e 


reviaion 1,1 

date: 2006/03/01 18:53:53: author; user2: state: Kxp; 
branches; 1.1.1; 

Initial revision 


revision 1.1.1,1 

date: 2006/03/01 18:53:53: auihor: userl: state: Exp; 
lines: +0 -0 

Original website project 


Concluding remarks 

Tlie Concurrent Vefsit>n System is a simple and cost- 
effective version conlrol system that is bundled in every MacOS 
X release. Tt enables you and your colleague.s to coordinate your 
conirihutions to the project while providing you the option to 
iievert to a previous unallered ven^ion of that same project. It 
alsf) provides a nuinlx^r of features that allows you to keep irack 
of various states of your project, 

lliis article has only shown you the fundamental capabilities 
of CVS, If you are iniea^sted in learning more alxmt the ttxil, 
esjxxially its administnitive and nenvork fealtires, you can consult 
any one of the online inelerent:es li.sicd at the end of this article. 

Bibliography and References 

CederqvisT, Per. Version Management with CVS. (c) 2003 Free Software 
Foundation. Online: <http://KimbioUom/cvs/manual>. 

Dreilinget Sean, Moshe Bar CVS Version Control for Website Projects, (c) 
1998, lnter@active Consulting Group. Online: 
<http://durak.org/cvswebsite5>, 

FogeL Karl, Open Source Development with CVS. (c) 1999, 2900 Karl Fogei, 
Online: <http://cvsbook.red-bean.com>, 

Wikipedia. Concurrent Versions System. In Wikipedia, the free encyclopedia. 
The Wikipedia Community, Feb 2006. Online: 
<http://en,wikipe(jia.0fg/wiki/ConcurrenLVe5ions_System>. 

_ 

About The Author 

Kb a fredaua a^meemg ama^ant tmenffy reaSng m Horth Ymouver, 
BC He ivides Us fime between wn/mji tedukel articles, md lead^ or^m 
to cMdrea at the local distikt pM Straries, 


WWW.MACTECN.COM 

















wcmm 






yiami iSSclB' 


Mini 


Missing a few issues? 

Here is your chance to catch up. 


The MaCTech CD - Volumes 1.01-22.09 Is packed with more than ever before - The 
entire archive of MacTech Magazine, that's over 2700 articles from more than 250 
issues (1984 - September 2006), all 29 issues of Apple's develop, 21 issues of 
Frameworks magazine, all of the source code, working applications, full documenta¬ 
tion, demos for techs, and more! 


Everything is displayed in the all new, very fast, 
very searchable MacTech Viewer! A new appli¬ 
cation that has been designed specifically with 
Techs in mind. Search quickly through 20 plus 
years of great information provided by MacTech. 
Information to make your life easier. 



Requires Mac OS X v. 10.4.5 or later 



Toll Free STT-MACTECH, Outside US/Canada: 805-494-9797 • http://vvww.mactech,com/cd/ 









































Corporate environments are known for behaving 
heterogeneoys technology systems,environments and [>eing aljle 
to move information l^et^^^een themclifferent systems is very 
important. Another known fact aboittAnd, ill’s very common for 
a corporate environments is that to use Microsoft’s Rxchange 
server is the as the company’s standard platlorm for emalk 
scheduling meetings, setting up contacts, and sharing 
information through public folders. 

Windows users iTcqucntly use OiUlcx>k to connect to 
I'xchange. Many Mac users have standardized on Entourage. 
But, w'hat happens if you want to share thrta Iietween Outkx>k 
and Bniourage. 

In tliis article, I will introduce you to two utilities that will 
allow one to move mformation from Outlook to Entourage, and 
vice versa. 

Outlook2Mac 

Fc;)r lIhjsc of you that don’t know , .p.st and .pab files are 
Micrasoft’s Outlook's way of storing email and addresses 
locally. The main benefit to Microsoft here is that it locks all 
of this data in an impenetrable fortress of a file that no 
developer has seemed to crack yet. However there are three 
ways I know of to get this data from your Outlook client 
(2000, 2001, and XP) inro Entoumge. Let's brielly take a 
moment to review our options. The two best options will 
recgiire a PC, although Virtual PC, Root Camp or Parallels, and 
B(K)t Camp will work fine as well 

1. ITie ‘"official Microsoft way requires you could upload all of 

that mail to the server, and the re-download it again. This has 
the benefit of Ix^ing very straightforward, and relatively 
simple. However, the one reason that wliy mosi many 
people have a .pst in the first place is that they have more 
mail than the server will allow. 

2. If you have too much mail to forwarci through your server, 
Tthird parlies have ouilinedhere Is a Byzantine more 
complex procedure that involves moving the pst to a 
Windows PC, importing it into Outlook Express, 
importing that in Eudora, and then processing the 


resulting mbx files into mhox files with some $20 
shareware ApplescriptsAppleScripts. Then you can drag 
and drop the results into Entourage. It should be noted 
though that this method will not import contacts or email 
attachments. 

3. The best method I have foundweVe found to tkite is a 
commercial product from Little Maciiines called 
OutlookZMac (02M). This $10 (yes, just $10!) application 
runs on a PC and will conven whatever you want into mbox 
files that you can drag and drop into Entourage (as well as 
cjlher mail clients) or any other Mac OS X mail client. It has 
a lot of flexibility and can export by folder and date range. 
It also will export with attachments and gives you the ability 
to filter the export Ijy size and file lyp^. Lastly, it will 
expoitdo your contacts as well. This will be the best $10 you 
will spend. 

To install and start Outlook2Mac02M, you will need 
download the prognim and install it on a Windows PC that is 
running Outkxjk. Ouilook2Mac 02M suppoas Micro.sofl 
Windows 95, 98, Me, NT4, 2000, XP or higher running Outlook 
97, 98. 2000, 2003, or XP. 

According Little Machine's Web site, it is rectjmmended that 
you use Outlook2Mac 02M while MicTosoft Outlook is open, 
iDecause 02M runs a little faster if‘ Outlook is already running. 
However, they caution you to not actively use Outlook wiiile 
using Ouilook2Mac02M. If you send mail, move folders, delete 
mini, or j^erforni other Outlook actions while Outlook2Mac 02M 
is sonning Ouilook or exporting your data, Outlcx)k2Mac 02M 
might get confused and fail Lo finish iLs job, requiring you tt) 
restart it. 

'i’he beauty of Outlcx>k2Mac is the variety options available 
at your fingertips: 

• You can pick one folder, or multiple folders (see Figure 1, 

page 38). 

• You can convert all email regardles,s of date, or select range 

of dates. 

■ For large attachments, you can tell Outlook2Ma(' to skip file 
attaclimcnts of a .specific size, or conven everytiiing. 


36 October • 2006 


WWW.MACTECH.COM 











Moving to 



Our technical expertise spans the entire spectrum of software development, including Mac and Windows 
applications, system-level programming, cross-platform design, handheld and wireless platforms, gaming, 
web development, and everything in between. We offer comprehensive development 
ervices including project management, software design, implementation, and quality assurance. Our work 
icludes commercial projects for worldwide external release, applications for vertical markets, and custom intra- 
lompany enterprise software applications. Check us out at www.crtticalpath.com | info@criticalpath.com 

2006 Chiical Path Software Inti Am tmclemaikit ate of (tioir 


Critical 



Mac 




Universal 

















• Because fsome email file attachments, such as ,exe and .bat 

files, may only be compatii^lc with Windows, you can select 
the kinds of file attachments that will not be transferred to 
Enioura>;c\ 

• When converting your calendar, you have the option of 
selecting all your appointments or with a dale range, 

• Additionally, you can choose to have your calendar convened 

to an Apple iCIal file. 

• When you send or receive an Outlook meeting invitation, the 

invite contaias the names of everyone who is invited. 
Outlook2Mac will try to convert these names into valid email 
addresses so you can replay or respond lo invitations by 
email on the Mac* 



Figure 1: Selecting which folders to convert 


You can find sLraighitbrv^^ard direttion.s on liow lo use 
OutlookiMac 02M at hltp://wwwJittIemach ines.com/ 
o2 m/help/wizard, html. 

From Entourage To Outlook 

Converting information fromto Entourage to OutltM>k was 
is a bk more of a challenge, and web searches don't yield a 
lot of great results on this. . I searched a variety of 
newsgroups and Web sites through Gocigle, after looking in 
vain on Mactopia, One name came upBut there's hope* : Paul 
Berkowitz, who has developed a number of specialized 
AppleScripts for Entourage. 

Paul's invaluable Export-Import Entourage 1*3^9 is a 
collection of over 50 scripLs to export and import almost 
everything - Contacts, Groups* Calendar Events, Tasks, Notes, 
Messages, Folders, Accounts, Signatures, Mailing Lists and 
Categories - fixjm one identity of Entourage X or 2004 to any 


other, to and from Entourage 2001* and to transfer Contacts, 
Calendar, Tasks and Notes to and from other PIM programs on 
the Mac and Windows, with special converters for Micitjsoft 
OullcK)k, Excel and other programs. 



Figure 2: Export-Import Entourage has many scripts to 
meet your needs 

The scripts enable archiving, restoration, and data 
synching or transporting. Some operations are not possible 
for all types of data, and some are not possible to or from 
programs that do not support the functions required. The 
Outlook and Other Converters transfer contacts, calendar, 
tasks and notes — there are insirucfions for transferring 
messages wiilioiil scripts in the Read Me. 

Export-import Entourage is shareware ($20.00). You may 
use two copies of the same or different versions (2004/X and/or 
2001) for one registration j^aymenl. Tliere is a one-time free 
nemo m<xle for exporting and imptirting 25 contacts. 

You can visit Paul Berkowitz Web site at 

<http://homepage,maccom/berko\A^it28>. 

Building on Entourage 

Entourage does a lot, but many limes you want to gtj 
even Furihcr. Fortunately, there is a way to make Entourage 
do practically anything that you warn it to, by using 
AppleScript. 

About Entourage’s AppleScript Support 

Entourage is very sc riptalile. It has an extensive AppleScript 
dictionary, wluch defines the AppleScript commainds that the 
appUc^ation will understand. Diclit>naries ai.si> define all the 
objects that programmers can manipulate with AppIcScTipt 
commands. ObjecLs am he all sorts of things within Entourage, 
such as windows, contact records, individual fields, email 
account setups, ailendar events, and so on. Ik.'aiuse Entourage 
is so scripUible, programmers can write scripts to extend 
Entourage's capabilities in many ways, enabling the program to 
perform actions that it otherwise could not. For example, there's 
no way within Entourage to duplicate a calendar event. But you 
can easily download and install a script that will do just that. 
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Te^c:liin^ AppleScript i.s beyond the scope of this article^ so 
Linfonnnately iJie rest of tliis article won't show you how to write 
your Qw^n AppieScript. But you will see how you can use tlie 
power of AppleScript within Entourage, even if’ you're not a 
programiricr, l>y using scripts written by people who are 
experienced developers (like Ben Waldie, and his excellent 
AppleScript coiuinn ever>^ month in Maclechl). 

Finding and Installing Cool Scripts 

You can download AppIeScTipts from many places on the 
Wel>, but there are a few sites that stand tJuL 

• AppleScript Central (www,applescript*corri) has a large 
collection of Ap]>leScTipLs for botit Entourage and many other 
programs, lipdated frequently, this site should lie your first 
stop when looking for useful AppleScripts for Entourage, 

• Mactopia (www.mactopiaxom) is MicrosofCs own Web site 

for all things Macintosh. A number of AppleScripts are 
available on the Download.s page of the site. Choose 
Help, Downloads and Updates lo open the Mactopia 
Downloads page in your Web browser, and then look or 
AppleScripts. 

• We are dLsappointed to report diat tlie website of Allen 
Watson, a major contjihutor to AppleScript Central, is no 
longer available. While he ha,s writ ten over 200 scripts for 


Entourage, they're now dilficult to find, but are surely still 
Ooaiing around the web somewhere. 

Once you've downloaded the scripts you are interested in, 
follow these .steps ro in.stali ihem in the 
Users/ usemame/D t ic umenls/Micrc>sofl I Jser Data/EnU ) u rage 
Script Menu Items folder. Once installed, confirm they’reit's 
installed by switching back to Entourage and make sure that the 
script appears in Entourage's Scripts menu (Entourage’s Scripts 
menu is the menu furtiiest to the riglit on Entotirage’s menu bar). 

Wrapping It Up 

'I'haUs it - the t! The secret is out of the box. Regardless 
of whether you prefer Windows or OS X, being able to 
transfer information hclwcen .systems can l>e paramount and 
the utilities profiled in this article will go a long way to 
information sharing a breeze. lAnd, if you are looking to 
l>uild on the base iliai Entourage provide.s, AppleScript may 
be a great solution for you. 

WW 
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Supercharge your Web Sites in Minutes! 


By Jin Lin, Emmanuel Stein, and Jamie Ferri 


Introduction 

There are many ways Lt> improve the performance of 
websites built upon Apaclie, PliP and MySQL, from simple 
modification of configimition file^ to recompilation of ilie stjurce 
code with customixed settings for your situations. In tliis article, 
we will focus on ettch ctjm{X)ncni of an AMP-Ixiseci system in 
turn, and address common ixittlenecks with .simple solutions 
that can lx: readily applied to your puiticular implementation, 

'Hie performance of websites is measured by the speed with 
wliich it is able to service ITITP requests. As distmssed in the 
April ‘‘Web Benchmarking 101" article, load testing tools like 
ApacheBench and JMeier am Ix^ used to gauge ilte performance 
of your web applications. In essence, these l(x>ls simtilate heavy 
web traffic by iastantiating multiple simultaneous rix|uests, while 
measuring resultant load anti response times. These reports are 
invaluable when l^enchmarking a server's response time and 
throughput across configuratioas. 

Apache Server 

RAM is the mast impojtunt varial>ie dial influences the 
jxTfomianee of A(xjclie .server. As RAM us;ige gcxfs up, frequent 
drive swapping incimses liie latency of ITITP reciuests. tiach httjxl 
prtx^ss uses around 2-3 MB of RAM whai sc!n iiig static' hlmJ pages, 
and as much as 15 MB when .serving dynamic jxiges, I3eaiiise the 
memory footprint of Ajyaclie pnH:es.ses grow to aecomniodate the 
cjuanrity of content Ix-ing served, tliey ran ntpidly take up an 
amount of RAM equal to the latgest and mast a)mt)iicjted scxipt on 
your system. In otlier words, even if onl>^ 1% of“ your web jjages are 
dynamic, eadi httpd prcx'ess will grc^w to take up in excess of 15 
MB of RAM, and will not releitse lesouices until the a)rres|X)nding 
[>nxx^s dies. Therefore, by prciperly adjusting the numlxr of httfxl 
processes, the server spawais, as well as iheii' Ifejxin, you can 
greatly Ixxist tlte perlbrnxincv of Aj:)aclie server. 

Tlx- following options, witliin httpd.conf, am lx 
tweaked to improve A[>aclie's use of memory. 

• KeepAlive - Creates persistent conneaions by keeping child 
processes busy while waiting for subsequent requests to lx 
sent over the satire connections. Persistent connedions reduce 
the overhead for setting up and shutting down multiple HTTl^ 
connections. By enabling this option we can dramatically 
improve tlic render Lime for HTML pages with multiple imiiges. 
Related options include MaxKeepAlivaRequests 
(maximum number of requests that can lx sent on a given 
connection IxTore it is ttlosed), and KeepAIiveTimeout 
(numlxr of .seconds Ajrache wails for the next request Ixfore 


closing connedions). Both of these impose a limit on 
KeepAlive to prevent a client fnim holding resources too 
long. Therefore, it is best to set KeepAliveTimeout to a very 
low value .such as 2 seconds. How'ever, if you liave more 
concurrent users titan availahle diild pnxes,ses, or if the server 
is only servmg dynamic pages, using KeepAlive will hurl 
overall performance and should lx disaf^led. 

• MaxClients - Limits the nuniber r>f child prcxesses the server 
can .spawn or the number of simultaneous ITlTP requcsls 
that can lx supported. Once this limit is reached, additional 
attempted connections will be queued up to the number 
.specified in the ListenBacklog dire^aivc. The default 
value for MaxClients is 500, Generally, it should lx set to 
a numixr big enough to handle as ntany simultaneous 
requests as possible, [>ul still small enough to ensure that 
there Is ample pliysieal memory for all [processes. This will 
avoid cxces.sive drive sw'apping. An easy way to test how 
many HTTP prixe.sses yotir system can handle is to launch 
Activity Monitor, enter httpd in the search field and 
make sure Al! Processes is selected. This will Use die status 
of every httpd pnxess running on your system {Pigure 1 ). 
To get the value of MaxClients, divide the amount of 
availahle memory by the mean RAM etjnsumpLion of the 
Apache processes. 



Figure 1. Activity Monitor - find out the RAM usage of 
httpd processes 
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* MaxRec]ue.sisPerChild - Sets the Tnaxiirtum niimlKT of 
requests a cMcl process will service before tlie cliild process 
kills itself'. Tills setting can reduce tlie total memory usage, 
and prevent memor>^ leaks by forcing child prt)cesses to die 
and restart willi a much smaller mcmorv' footprint. The 
default value in Mac 0!> X is 100,000. You might want to set 
it to a lower value if you find that some of your httpd 
processes arc using loo much memory. 

* MinSpareServers, MaxSpareServers ^ Regulates how a parent 
pnxess spawns child prtKesses in order to service recjuesLs. 
Creating child processes is expensive. As long as the server 
is busy cTeating more child processes, it won't be able to 
serve luser requests. If your site is event-driven, such that the 
numixfr of connections IlLictuates radically in short periods of 
time, you should increase the value of MinSpareServers, 
On the other hand, you should avoid setting 
MaxSparoServers Ux) liigh since excess diild processes 
will take up resources unnecessarily. 

* ExicndcdSlaius - Useful for cxillccting server slatisties such as 

the smrus and CPU usage of each child process, the number 
of recfuests per second, and more, lliis setting is enabled by 
default and is at the expense of extra system calls. With 
Ext ended Status enabled, web server statistics can [)e 
accessed via littp://localhost/server-status. You can also gel 
I he status page refresh itself every N seconds via 
litlp://locaIliosl/serv'er-status?refresh-N. This can be very 
useful for optimizatioii, and debugging, However, 

when you're not in active testing, you should disable this 
option to leckim extra CPU cycles. 

Other w'ays to im]>rove Apache’s peifonmnce include di,sahling 
k>gs when Linnec:es.sary, disable use of Hitaccess via 
AllowOverride none, and elioiinating unused incxlules, Ajyache 
Performanc'e Ncxes (http://hnpd.apache.org/docs/r,3/mtsc/perfduning,titniI) 
offers additional tipts on Apache tuning. If you don’t need the 
extensive featum set offered by Apadie, you may want to cxmsidcr 
a lightweight alternative. An example is LighflPD 
<http;//www.lighttpd.net/>, whose .strength is eflldenr handling of high 
traffic volumes on older systenis, and wllicit includes many feattires 
such as PI IP, CGI, SSI, and UliL-iewnting. 

MySClL 

MySQL, as a database server, does a lot of data transfer 
between disk and CPU. Disk I/O will thcrehire he the first 
bottleneck that you are likely to encounter. To decrease disk 
I/O, the various internal buffers of MySQL use nniu memory as 
a cache for data That is on disk. MySQL has global butters in 
addition to per-lhread buffers. The general rule of thumb is that 
the main memory available to MySQL .should be big enough to 
handle MySQL’s global buffers plus per-thread buffers multiplied 
by the maximum number of concurrent conoeclions being 
created. By properly adjusting the amount of meinoiy' that 


MySQL alkx.atcs to each of these l)uffers, you will gain 

significant performance improvements. 

Here are some key parameters in my. enf that can be used 

to decrease disk I/O: 

Global parameters 

• key_buffer_size - Key buffer is a global buffer that stores 

MylSAM (ilte default storage engine) indexes, Eveiy time a 
block of index values is referencedt it will be loaded into the 
key buffer. In order to scan a table’s index faster, a query 
reads tlie relevant indexes from die buffer rather diari die 
disk. Unfortunately, when the buffer is full, some values 
stored in the buffer must be discarded to make room for new 
values. It is reccimmended to set this value between 20% and 
50% of the total memory on a dedicated server, or the total 
size of .MYi files (index files) on a shared server. If you don’t 
have that much memory dedicated to key buffer, you can 
tune tliis setting liy comparing the Key_reads (numl:>er of 
requests read from disk), and the Key_read_requests 
(number of requests for a index block) status variables. The 
ratio of Koy_reads to Key_read_requests should be less 
than 1%. or 1 Key^reada for eveiy 100 or more 
Key_read_requests. Use the show status like 
*%key„read%' command to reveal these two values, and 
use the show variables like ' %key_buffer%' 

commaiid to find out the key buffer size. Note tliat the key 
buffer is only for MylSAM tables. Other talile types have 
different parameters for tuning (e.g. 
innodh^huf fer„pool_size for InnoDB tablex). 

• table^cache - Limits the maximum number of tallies that can 
lie opened at once. With MylSAM tables, each table and 
index represents a separate file. Because opening and 
dosing files is relatively slew, MySQL puts tables in cache 
until they are explicitly closed, or tlie toml number of open 
tables exceeds the tabl 0 _cache parameter. Increasing the 
value of table_cache will lie helpful if you have a large 
numlier of tallies on your server. To determine whether the 
table_cache value needs to lie increased, type the 
following at a mysql prompt: 

ehow variables like ' table_cache' r 
show status like *open_tabies': 

If the value of opon_tables is .significantly bigger than the 
value of table_cache, then you should increase the value 
of table_cache, 

• iiiax^conncciions - Controls the maximum number of 
simultaneous client connections. The default value is 100. If 
your .server is very busy, or if the value of ihc 
Thraads_connected statiis variable approximates to tlic 
value of max_conn0Ctions, you should increase the value 
of the latter to allow for more connections. 
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Per-Client Buffers 

Exercise caution when intTcasing Uie value of persrlient 
varia[>lcs as iliese buffers arc alltKated on a per conneaion 
basis. The value of diese buffers should not he icx) high; 
otherwise, the performance of MySQL or oiher pnK'esses may 
suffer due lo exort>jtant memory consumption. 

• read_buffer_si7e - Specifies the si7e of the buffer iltat is used 
when a full table scan is perfonned to store the table data. 

• reiKLrnd_buffer_si7e - Determines the si;^e of the bulTer that 
is used in reading rectsrds after an intcniiediate sort. 

• soft„buffer_size - Determines the size of the buffer that is 
u.sed during read and .son opcTations. 

• join_bitffer_si2e - Determines the size of the buffer that is 
usetl to process joins. 

• max_anowed_packet - I’lie maximum size of the buffer that 
is used for client communication. 

• Lm[3_tal>le_size - S}X^dfies die maximum size of tetnporary tables 
that CAn Ix" stt>red in the memory. If the value is t(X> small, 
MySQL will plai'e iht: temporary^ table on disk. To detennine the 
profXT value for tmp .table_size, compare the values of 
Greated_tnip_tablea (niimlier of temporary tables that are 
created), and Created_tmp_d i sk_tables (number of 
temfximry tables tiiat are ]>laced on disk) .status variables. You 
sluiuld increa,se tDip_table_size if the ratio of 
Created_tnip_disk_tables and CreatBd_tmp_tablas 
exceeds 2%. 

Query Cache 

• query^cache^type, <fuery_caclic_size * Determines the 
operating mode (0 for off, 1 for on, 2 for on demand), and 
size parameters for query cache. Itie query c:ache keeps the 
results of frequenrly executed SELECTS in memory .so that 
MySQL doesn't need to access the slow disk-based 
subsystems, lliis works as follows; Ibe first time a given 
SELECT statement is exccutai, the server rememtiers tlie 
tjuery and die associated resales. The next time the server 
sees that statement, it pulls the results directly from the ciuery 
cache and returns it to the user. MySQIAs query cache is case- 
.sensitive suc:li that, each query tiiust be identical (e,g. no 
extra spaces), llie default value of query_cache_size is 
set to 0 and effectively di.sable.H the cache even if die value 
of quGry_cache_type ts non-zero. To check out the 
[performance of the query atche and its use of memory, run 
the following command: 

show status like '%<icache%': 

• Qcache_lowmem_prunes - Counts the numlx'r of queries 
that have been removed from the cache in order to free up 
memory for cacliing new queries, Tltis can be used to help 
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dcLcrtnine query caelie size. Under certain circumstances, 
such as when queries retrieve data from a coastanr table, the 
query cache isn't very useful and should be di.sabled. 

For a more detailed treatment of MySQL server perfomtance 
aining coasult <http:y/dev.mysql.com/books^pmysql-exceiptVdi(>6.htrnl>. 

PHP 

PH? uses a twt>-parl process for generating HTML: each 
time a PHP saipt Ls accessed, ii is first compiled into opcode, 
which is then executed to generate the htniL ('Hiis workflow can 
be seen in figure 2). This reptrating prcK'es,s of compilation and 
execution, not only places significant demands on tlic CPU, but 
also increases the latency of \ rrPP requests, especially as scripts 
grow in complexity. Bec:ause it rakes much longer to serve a 
PHP .script titan a static html page, we can employ various 
caching schemes to minimize the process of compilation and 
execution, and thus boost web performance. 



Figure 2, PHP script workflow 

If your pages cliatige infrequently, you will want to choose 
a caching mechanism such as Smuny or Caciie_Lite to store the 
entire HTML output of your PHP script. ,Smarty 
(htlp://smafty-php.net/) is a [t>bust templale framework, which 
separates business logic (PHF code), from presentation (HTML 
templates). Smarty offers the ability to cadje all t)r pan of 
rendered HTML. For infonnalMJn on installation, setup and use, 
consult the excellent documentation on Smarty’s website 
<http:// 5 marty.php.net/nianuat/en/>. Because Smarty rec[uires you to 
restructure your PHP codes, a simfilcr alternative is Cache_Lite. 
C:ache_Ijte provides a solid, easy-to-implement library for 
solving cache-related issues. It is easy to install via the PEAR 
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(PI IP Extension and Appliauion Repository) Package Manager 
that comes pre-installed with Mac OS X. 

To install Cache_Lite, type llic following into the terminal: 
sudo pear install Cache_Lite, Once installed, wmp the 
following ccxie amund your PHP scripts to enable HTMl. cradling: 

Listing 1: Cache_Lite code wrapper to 
enable HTML caching 

// liidiidc the OK'he_Ute ptkagc. 
require^once ( “Caehe/Lite/Output.php” )s 

// Define options to contml the behavior of 
// Caehe_LiTe_Oiitput object. 

Soptions = arrayf 

'cacheDit* "> 'cache/', 

'lifeTijie* => 3600. // expire after 1 hour 

*pearEri:orMade‘ =) CACHE Ll'M ERROR _DIE 
): 

// histantiaie Cadie_Ute_Ouipui object 
$cache ^ new Cache_Llte_OULput{$options); 

//Test if the l ached file is exists. 

// If so, use the cached file. 

// Otlierwise, conijiile and execnie the POP codes and rendered a 

// cache file with the ID specified below. 

if ( 1[ $cache > start ( “index".$q_strlng ) } } I 

r YOUR PUP CODE HERE V 

//1 he (lid of CaciiL-_Iitc_Outpiit object 

$t:adie > end(): 

1 


You enn now run ApacheBench with and without 
Cadio_Lite in order to measure the performance improvement. 
In this example, 1 chose to set the number of requests to 1000 (- 
n 1000), and the number of simultaneaus ctjnnections to 10 (-c 
10), The perfoniiance with and without Cache^Lite enabled is 
seen in figures 3 and 4, respectively. 
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Terminal — bash 


Document Pothi 
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Coi^Lete requests: 
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Figure 3. ab results for the script w^h Cache.Lite enabled 
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Tennfnal — bash — 76x13 


Document Path: 

l onl/i ndex_na„cadie .php?caUi06 1 
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Figure 4. ab results for the same script without 
Cache.Lite 


As you can see from the two terminal outputs, it took 
about 12 seconds to serve 1000 requests using 10 
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simuluincous connections Ibr the script with Cache_Lite 
enabled, versus 77 seconds for the same script without 
Cache^Lite. 'I herefore, the script with the caching system can 
be served 6 times as fast as the one without. As the size and 
complexity of your scripts increase, tliis speed difference will 
be even greater. 

!f your page changes mirre frecjuently, such as with a 
stock quote, cached HTML will obviously not be suitable. In 
this case, you will want to choose an opcode cache. Opcode 
caches keep compiled PHP scripts in memory to eliminate 
die need to recompile the script for each subsequent request. 
Well-known opcode caches include e Accelerator 
<http://eacc[eratornet>, PHP Accelerator <http://www.php" 
accelerator.co.uk/>, Turck MMCachc <http://turck- 
mmcache.sourceforge.net/>, and Alternative PHP Cache 
<http://pecl.php.net/package/APC>. If you do not wish to go 
through ifie trouble to set up opcode cache, you can simply 
download MAMP (Macintosh, Apache, JViyyQL, PHP) from 
<htTp://www,mamp,info/en/home/>. This packaged solution 
comes with additional libraries such as eAccelerulor, Zend 
Optimizer, and [>iipMyAdmin, among others. 

You can further improve PHP performance via other 
tiiethcxis, such as using output Ixiffering. It is always g{K>d 
practice to ensure dean, optimized code with the aide of 
])rofiling ttK)ls such as API) and DBCL 

Conclusion 

In this artide we've explored .several performance tuning 
techniques that can he applied individually or in combination 
to enhance the perlbrniimce of AMP-based sites. By making 
changes to the Apache httpd,eonf file, adjasting MySQI/s 
memory use, and properly caching PH? generated HTML 
output, we demonstrated how to achieve significant 
performance improvement without purchasing additiona] 
hardware. Whether you are running a complex content 
jiianageEnent solution or liosting a personal blog, these 
]>iactical guidelines will allow you to rake your web 
applications to the next level within minutes. 


Till 
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Mac In Thc Shcll 


by Edward Marczak 


Easing Into 
dsci 


Manipulating Directory Services 
via the Command Line 
_/ 


Introduction 

Once, centralized directories were a iohy corporate gtjul, 
Now, liowever, they increasingly play an i in porta rtt role - even 
with a single machine, dscl, die directory services eornmantl 
line, is a new, all in one way to access and manipulate 
directory services information. This month, we’ll delve in 
worlds outside of the shell proper, I Hit see how we can 
manipulate and interact with those other realms via command- 
line toots. Tliis monlh will focus mainly on explaining 
directory sendee concepts. 

Directory Services 

To explain dscI, I also need to explain directory services. 
The term itself has no specific technical definition - kind of 
like "web services” or '‘wch Z-poinl-oh.” Yon know them 
when you see them, however, two wel) 2.0 sites can use 
dilTerent technology altogether. Directory services is a 
concept. The concept is that all directory information should 
have one interface for access. Different applicatit>ns shotild 
1 x 1 able to access this information for a variety of purposes. 
This inlbrmaiion may he purely centralized, distributed or 
replicated. NeXT Computers developed a diretlory service 
railed Nednfo. OS X inJierited this directory service for its 
initial releases. Neilnfo was gCKxl in its day, but Apple knew' 
a system with more flexibiliiy was needed. Enter 
Open Directory, Apple's current directory service. Like other 
directory services, such as Novelfs eDir, Sun’s yp/NfS or 
Micro.soft's ActiveDi rectory, Open Directory is a modern 
directory implementation with an LDAP interface. Unlike the 
other two mentioned, Apple’s system is completely siandards- 
based and easily manipulated. 


LDAP 

LDAl* the Lightweight Directory Acc'ess Protoex)!, surfaced in 
1992. Ifs '‘UghmeigliC only in relation to X.500, die Directory 
Access ProKxx)!. Somewhat like liglit i>eer - it needs to Ix" 
compared to somediing else to he considered ‘lightweiglit’. It is 
a protocol, and nothing more. It Is not a database in and of itself, 
li may provide access to one, but doesn’t to. AH it must dtj 
is accepi requesLs and answer I hem - whether tlxit answer comes 
from a database or not is of no concern. LDAP categoiizes its 
information in a hierarchical tree structure. Following most digiUil 
trees, the rexK is visualized at the top, or on the side. Each branch 
is a container, and c-acli leaf is a ret:cxd. I1iis is the Directory 
Information Hree, or, DIT. It's e'jsic'st if wc visualize this. Figure 
1 shows a basic LDAP hierarchy. 



Figure I: A sample (and very basic) Directory Information Tree, 

LDAP uses some very specific terminology to designate 
container and leaf type.s. One similarity to a relational database 
is that they are Ik>iJi sirongly-iypc'd and use structured 
information. A distinguished name, or "‘DIST, represenLs a 
imicgie identifier for a record. Hlie top of the tree is called the 
base DN. lliis Ls typically defined as an *^0" {Organization), or 
a series of DC records {Domain Componenls). ‘'OU” stands for 
organizaHoml unit. Ibis i.s a container that ailows you to 
organize other types. 

OpenDirectory 

Now that weTe thn iugh I lie world’s briefest introduction to 
LDAP, let’s take a look at Apple's OpenDirecu>ry. 
OpenDirectory is incredibly interesting because unlike 
Active Directory and eDir, which are basically 'one thing’, 
OpenDireaory is many tilings. On iLs own, it stcjres information 
in a BDB database via LDAl'^. Additionally, it ships witli several 
plug-ins that alkm^ it to act:ess other direaory systems such as 
ActiveDirectory, Finally, you can map OpenDirectory records 
into attributes provided by other system.s tliat expose tlieir 
directory through T.DAP. What this all means is tkil when you 
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use a directory tool on OS X to (jiiery infoniiaiion fn>!ii the 
service* you may noi lx: 100% sure whea^ that data originate<i* 
lx; it native to OpenDirectory, or, puUecI from another system 
over a network, 

Some of the early Impetus for directory services was 
simply to have a single place to perform lookups for basic 
employee information* such as phone numbers, c-tnail 
addresses, etc. This is precisely rme of the functions that 
OpenDirectory provides (easily in Tiger, you have to jump 
tlirough some hoops in Panther). 

A Case for the Shell 

As is slightly typical* I feel 1 have to convince" people iliai 
there are cases where command-line iix>ls l>eai out a OUl. Of 
ctjurse* tliere are GUI ttK)Ls, such as Workgroup Manager, that 
manipulate directory informiition. In many c’ases, these* are the 
right tools. However* using the shell clearly trumps tlie GUI in 
these cases: 

• Automated importing/exponing many users in/oui of a 
directory .servkr. 

• Watching log hies while yoiPn: in ihe GUI console. Server 
Admin's siateles,s HTTP log jKjlliiig just doesn't OJI it. 

• Troubleshooting while someone else works at the GUI 
console. Tve used this to great effect. Sometimes, a 
macliine is having an issue tliat niiike is a little off-kilter, but 
work can still be accomplished. Fine, lei the end-user get 
some work done. You c*an lx* getting w<3rk done on tliat 
machine, lckj, via ssh. 

1 don't think IVe really found anyone, thougle who, once 
shown how the shell can benefit them, thinks that it's a bad idea. 

What’s all this dscl then? 

Onto Lite real topic of this article! While OS X Server started 
off with Netlnfb as its “native'* directory service, OS X still uses 
a Netlnfo database to store all kK:al account informadon. 
De.spiie this, OS X’s directory serviceswith its ability 
to use plug-ins opens an API to accessing any directory service 
set up through the Direaory Acces,s appliaition (located in your 
Utilities folder). The long-standing niutU (Netlnfb utility) 
program, which can only read and write into Nednfo, has been 
superseded by dscl, which can read and write liirough tlie 
directory services API - in other words, it can read and write into 
any directory service configured through Directory Access 
(audiorization permitting). 

Interestingly, dsc:l itself provides an interactive .shell (with 
biLsi(’ tab-completion, too!). Let's gel our feet wet there. Open 
up a shell on the macliine you'd like to be working This 
means that you may want to ssh st)mewhen: if you need to. At 
the prompt, type dscl: 


aock-Xcrcuok:- aorezokS dscl 
dscl (v20>4) 

usage: dscl [epttems] [<dQta$Qurce:»- [.^coaMnd>]] 
dstosource: 

locQihecst (defoult) or 

■dTO®tnaire> (r^ires OS proxy support, or 

<Tioderiame> (Directory Service style riode name) or 

<doiiainna!ie> (Netlnfo style ckxiQin noae) 

Ofrtions: 

^ <iiEer> outhentlcdte os user (required yhen usifig OS Proxy 


Figure 2r dsd with no arguments defaults to a dsd-shell 

Aliliougli it's not shown in figure 2, you should note the last 
line of this output: “Entering interactive mode../, where you are 
dumped at a prompt. Typing Is lisis tlie suixtirectories or 
cj|>jecLs of the current palJt: 


> is 

AppleTalk 

Bonjour 

LDAPv3 

Netlnfo 

SLP 

SMB 

feorch 

Contoct 


Fig S: dscl directory listing 

Since we all have a Netlnfo directory, I'll sran there. Using 
cd, you can change into the Netlnfo directory (cd Netlnfo). 
Doing ,so will change ilie prompt to show that you're now out 
of the root directory and into a sulxlirecroiy. Again, typing Is 
will help you get your lx;aring.s. If youVe ever used Netlnfo 
Manager, this should kx>k faniiliar: 


/Netlnfp/root > is 

AFPUserA liases 

Aliases 

Config 

Groups 

Hochines 

Metworlcs 

NFS 

Pri raters 

Protocols 

PPC 

Users 


Figure 4: DispEayiitg the local Netlnfo root 

From this point, change into the Users directory (cd 
Users), Is if you’d like to gel a list of users stored in Netlnfb, 
and then change into the user of your choice (cd 
username). If you’re rushing ahead, and type Is* you may 
be surprised. You don't “HsU properties, you read them. So 
type read, and press return. This will list all attributes for the 
account in question. 
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App lettetoKodeLocQt ion: /NetIrtfo/root 
MJttiefttloattonAuthority; sShodoyHosh; 

AulhentictitiortHtnt; 

GeneratedUlO: 

rectory; Ateers/iorczafc 

Pos^word: 

Pi cture; /L \ brory/Coches/coei le .userSeipictureCoche, user I wage 

PrieoryGroupIb; 501 

ReatNooc: Edward R, ftorczok 

RecordNQna: marczok 

ReccrdType; dsRecTypeStCJndard: Users 

UniquelD: 501 

UserSheil: /btn,-lscish 


Figure 5; Reading a Netlnfo user account 

You am rept^at this exercise for the LDAPv3 branc^h of the tree, 
if yoifre tbmmalc enou^^h to l>e connected to ;m LI3AJVOD sk>re. 
TyjX! quit, and y<Hi1l lawe dscl, ancf be returned to your Utiix 
shell. Let's see how to drive d-scJ tJULsidc of its interaaive shell. 

To read the same user information directly, we can use 
dscl iliusly: 

dscl Localhosi read /Netlnfo/raot/Userg/narczak 

If you just warn lo pick out certain keys you can supply 
them after the pailu 

$ dscl local host road /W&tlTifo/root/Usors/iaarcaak UniquelD 
RealNanii? 

Utilquctn: SOI 

RoalNaner Edward H. Marczak 

Keepinj^ in ininci that we're easing into dscl Til save some 
of the more in-depth information for future months. However, 
there's .still plenty mom to note. 


WeVe been icsing using dscl to kmk at a Netlnfo store on 
tile local host. We can also specify an LDAP store. To get the 
siime infoniiation from tlie LDAv3 node, you need to specify 
I.DAP as the datasource: 

dscl /LDAPvl/lycaeifln.radiotopa.CoiB -read /Users/marezak 

If you're Rimiing this from a server, as you often may if you have 
an auiomaied sirripi, you c'^an also use the IcKralhosi dasignadon 
of 127.0.0.1 in place of Llie node name. 

Some operations require authenliojiUon, s<) you'll need to 
supply that information, too: 

dscl u [directory tidninl -P Ipassword] /LDAPv3/127,0.0.1 - 
delete /Users/marczak 

For tlie security conscious among you, and that's hopefully 
everyone, instead of using the ““P" switch and specifying the 
password on the command-line, you am instead use ““p" to 
have dscl prompt you for the pas-sword. Naturally, certain 
situations call for certain Ixrhavior You can't :miomate a nightly 
rouiine and have the operation halt, waiting for a password. 
11 lose .scripts need to be protected appropriately. 

One underapj>reciatcd mode of dscl is "authonly". Says 
what it does, does what it says: leses authentication of a 
username/passworci enmbinution. Watch it in action: 

lycacum;'' root# dijcl /LDAPv3/127*0.0.1 authoniy marezak asdf 
Authentication for node /LDAPv3/127,0.0.1 failed. (-IA090. 
eOSAuthFalled) 

XycaeuDi:-^ root// dec! /LDAPvJ/127.0.0.1 authnnVy marezak 

myrealpaas 

lycaeutn:-' rootjf 
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[n grand Unix fashion, no news is gocxi news. On the first line, I 
supply a known-bnd password, and get back die appropriate cm>r, 
autliorizaiion failed. On the next line 1 give the right credentials, 
and get back....nodiing. (Teclinically, you get a “0” error code, 
anyone remember where that was covered? echo $?). 

Combine dscl with traditional bash scripting and you can 
automate routines, and do tilings that can’t be done in 
Workgroup Manager at all! flow alxiut a re[X)n of all users, 
listing tlieir full name, short name and home directory? 

/bln/bash 

for i in 'iacl /LDAFv3/127hO» 0.1 -li^t /Ueers' ; do 

dscl /LDAPV3/127.0.0.1 -read /Ugers/$liJ RealName uid 
homeDirectoty | awk *BEGTTJ tFS”":'] Iprint $21’ 

&cho 

dong 

Making the file executable and ninning it produces (partially): 

./tiRerrgp.eli 
Directory Adudnistratqr 
dlradmin 
/Users/diradmin 

Dorothy Marezak 
dorothy 

/Network / Servers / lycaeiiiii, radiotope. coia/Users/dorothy 

Edward R. Harezak 

marezak 

/Netvork/Servera/lycaeim. radiotope*com/Vo 1 iimoR/Daia2/Uaer5/isaxc 
zak 

Conclusion 

dscl Ls a priwerhil, and handy, tool as it will R^jxjrt on and 
manipulate the infonnaiion in any acces-sible Directory^ Service 


store. As with many command line utilities, ifs real power 
comes when automated as part of a larger script. Data are only 
useful if they can be used, accessed and reported upon* 
Sometimes, you need to write your own tools to gather the 
precise information that you’re looking for. 

Media of the month: criuy Kawasaki’s Art of tbe Start. Despite 
being a two year old title, it’s still incredibly relevant. If you're 
sparked by new' ideas and warn to see diem become reality, this is 
Mjrne fantastic reading. Plus, there’s the gratuitous A[if)le Ue-in, 

Also, it shtxrks me that, having just returned from WWDC, 
MacWorld is nigh* llojie everyone is making their plans. For 
those attending, 111 see you in San Francisco! Of course, Til see 
you in print next month. 
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My CUPS Runneth Over 


Taking the power of printing to the next level in Macintosh OS X 


CUPS 


Inckidccl witli Mac OS X ,since the release of Jaguar, the 
Common Unix Piinting System, CUPS, gives a systctn atlministrator 
greiU flexibility and pcwer Many Unix system administrators are 
quite fatniliar with the inirieacies of this system. Mac OS X takes 
adv;mtage of tills flexil:)ility, while at tlie same time tin>%ading a 
very simple interface for printer management. In this article, we 
will delve deeper, examining the command line for use in printer 
iiiLinagement in OS X. As an added Ixmus. managing printers from 
the command line works lx)th on Macintosh OS X and Macintosh 
OS X Server! Ijci's Ix^gin by recapping the printer interface as it 
appears in Tiger. 

Printer Setup Utility 

*rhe Printer Setup Utility is an evtjlved bea.st. When first 
introduced as Print Center in Jaguar, many oplif>ns were nt)t 
present. Wiih each release of the openiiing system, more 
options have Ix^en added, allowing for greater printer control 
Figure 1 shows the interface as it appears in Tiger: 
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Figure T 

It appears pretty normal, ch? The obvious things are here: 
Adding a printer, Qilorsync, Utility, and Show Info, Each item 
is pretty siraighlfonvard. How does rids relate to CUPS though? 
Ail in due time... More interesting options now appear in the 
Aild Printer box. By default, various types of printers are 
omitted from the Add Printer dialog. Clicking on the More 


Printers button allows users to add juany more lypt-^s of 
printers, including Bluetooth, SMB (Windows), Appletalk, and 
Ollier printers using TCIVIP protcx'ols that do not use the Line 
Printer Daemon (LIT)), or Bonjour. Prior lo Tiger, adiling these 
types of printers required using a sjiecial key combination. 

Even more opiions are available in the Printers Menu Item. 
Figure 2 sliows tlie opiions tluii are available. 

Make Default atD 

Add Printer... 

Delete Sefeaed Printers 5S^ 

Pool Primers... 

Configure Printer 
Supply Levels ,. 

Print Test Page 


Show Info 


Show Jobs 

SCO 

Stop jobs 


Create Desktop Primer,. 

<$nD 

Figure 2 



A lot of new opiions have appeared in Uger, let's now 
liegin to see how ihcy can tie to the command line. 

Command Line Magic 

So, you ask, why would 1 want to use the ctmimand line 
instead of using the Primer Setup Utility application? What 
if you are aitempling to administer a renmte site? How about 
using the Send Unix command in Apple Remote Desktop? 
Removing stuck jobs from a printer? The list goes on. Often, 
an administrator may Ix^ able to accomplish many commem 
tasks using their preferred administraiifjn loolSj be it ssh, 
ARD, or some other way of delivering custom user settings. 
Using Figure 2 as a point of reference, each option can lx 
accomplished with the command line. For simplicities sake, 
all the command line options below assume that at least one 
printer has been added to the system with the Primer Setup 
Utility. 

Setting the Default Printer 

The first option, Make Default is relatively simply 
accomplished using either Ipoptions or Ipadmin. In this 
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case, Ipadniin makes more sense, as it will be the basis for 
many of ihe other command line tasks in this article. Here's 
the command: 

Ipadmin -d prititer^iiame 

Simple. Well, not quite. Tire command is fairly simple, 
getting tlie printer name is not. The queue name is typically what 
is needed to prc^periy invoke this command. If the machine is 
tx.4ng remotely administered, the cjiieue names for all attached 
printers can be ol^tained witlr the Ipstat command. Get ready, this 
c'ommand is a little long: 

Ipstat -V I awk * 1 sub53): print $31' 

You might ask, why ail the extra stuff with awk? In this 
case, it is simply a matter of convenience, as the printer 
name.s are all listed as known by the system. Typically, an 
IP printer name will be in a form similar to 
_192_163_1_108 when added using Printer Setup LStility. 
The last bit of trickiness is that Printer Setup Utility iisually 
writes a file to the user's home directory that will override 
any setting that you send to the client machine. This file, 
.Ipoptions, can be removed. The alternative of course is 
simf>ly place a new file with this name on the client machine 
in the users home direclC3ry with the word Default before 
the printer name. If a global setting is what you are after, 
create this file in /etc/cups. Name tlie file here lpoption.s. 
Always remember though, a local .Ipoptions file will always 
override any global setting. 


Deleting Printers 

For now^ skip the Add Printer option, Moving to the delete 
printer menu item, it ts very similar to the command for setting 
a default printer. Once again, tlie printer name is needed to 
delete the printer, 

Ipadmin -jl _192_163_1_1Q3 

This command will remove tlie named printer from the 
system. Pretty simple. 

Printer Pooling 

Let's get a little more complex now. Printer pooling is a new 
concept. Ginsuliing the CUPS dexumentation, iJiere is nothing 
regarding printer jiooling. In llic CUPS dcx:umentation, printer 
pools are referred to as maniigenient classes. Joiis sent id a pool 
(ckiss) are sent to the first availahle printer. In an office with all 
printers in a cenlralb:ed loaidon, tliis option could be of ,somc use. 

IpadsUn -p _ll}2_l68_l_l08 -p hp_Color_LcLi3erJel_5550 _EABEF6_ 

c (fiyprinterpool 

By now, the command should being to look somewliat 
familiar. The -p option simply specifies the printer name that 
will be addetl to the printer pool. Each printer must be specified 
when creating the class. The la.si option is the pcxil name, 
specified with the-c optitm. Once finished, a new printer pool 
should appear in print center By default the printer pool will 
lie stopfied, it can be started in the same way as a printer. Read 
on to find out how.Configure Printer 
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We've looked at two of the three lynchpins far camoiand 
line cups administration* The last cxJinniand, Ipoptions is 
used to view settings for a named printer. Tlie command syntax 
is quite similar to Ipadmin. Let s look at a command, 

Ipoptions -i -p 192_16&_1_108 


Tlijs command will remm aD of the available options for the 
printer model. It will look similar to the following output: 

HFFaperPoiicy/Fit to Pager *FroraptUser NearestSi'/ieAdjiist 
Hea re 3 tS1 2 eNoAd j ust 

InstalledMeraory/Total Printer Hemoiyr *SHli 16Mli 24HB 32MB 4eMB 
64MB 

HPwmSwJtch/^^atermatk/Overiay; *Off Watermark Overlay 
JJFwmPages/Watetraark Pages: *AllPagefi FirstPage 
HPwmTextMessage/Watermark Text: •Draft CompanyConfidential 
CompanyProprietary CompanyPrivate Confidential Copy Copyright 
FileCopy Final ForlnternalUse Preliminary Proof ReviewCopy 
Sample TopSecret Urgent Set 

HPMmFontHame.^Watermark Pont: CourierB •HeivetlcaB TinesB 
HPvtnFotirSI 2 e/Watermark Size Cpointa}: pt24 pt30 pt36 ptA2 
•pt48 pL54 pt60 pt66 pt72 pT?B pt34 pt90 

ttlvralextAngle/Watermark Angle: Deg^O Deg75 QegfiG *Deg4S Deg30 
Degl5 I>egO De^l5 DegN30 De6M45 OegNfiO DegNll negS90 
HPwmTextStyle/Wateniiark Style: Thin 'Mediim “rhirk Halo Fill 
HPvraBrightneEs/Wateriiiark Intensity: Darkest Darker Dark 
MediumDark *H 0 dium MediumLigbt Light Lighter Lightest 
Snoothing/Re^olution Enhancement: ’PrlnterDefauit On Off 
PageSize/Mcdia Size: •Letter LetterSmall Executive Legal 
LegalSmall A4 AASmall A5 A6 IS0H5 B5 wfiiah936 Postcard 
DoublePostcard v518h//4 EqvlD F.rrvHonarcH RnvDL EnvC5 EnvIS0B5 
Custom 

FageRegion/PageRegion: Letter LetterSmall Executive Legal 
LegalSmall A4 AASmall A5 A6 1S0&5 05 w612h936 Fostranl 
DoublePostcard v558h774 EnvlO EnvNonarch EnvDL EnvCS EnvIS0B5 
TnputSlot/Media Source: •Upper 
HarmalFeed/Tray 1 (Namiall: True ‘False 

HPHalftone/Levels of Gray: *PrintcrDefault Enhanced Standard 
Resolution/Printer Resoiuiioii: 120Dxl200dpi ‘&00x600x2dpi 
600x600dpi 300x300dpi 

HFEconoMode/EconoMode: ‘PrinterDefault True False 


Tliese opiioas :irc usually dirucily frt)m the PPD file for 
the printer Choosing a S(>ecific opt Urn from the above list^ 
the resolution of the printer can he set with Ipadmin using 
this command: 

Ipadmin -p _192_168_1_108 o ResollUion^l200x1200dpi 

Unforturuitely, many of these options are not exposed in ihe 
Printer Setup Udlity. Addilkmally, the most useful tool, page 
size, cannot be set from the command line, as a Preference plisi 
is actually used by the OS X priming system. 

One liners 

A lot of the remaining menu options on tx.^ acetiinplished 
with a single line ccminiamf Stopping jobs requires one line 
disable printer name. Restating the queue is just as easy, 
instead of disable printername use enable 
printer name, Once you open the Printer Setup Utility using 
either command, the state of the prim queue will 1 k" stopped or 
started based on tlie command entered. Eiirlier, printer pools 
were discussed. Here's how you enable the printer p<M>L use die 
command above, anti substitute the pool name for the 
printername* Once you have enabled the queue or pool, it 
nc\:ds to lie configured to accept or reject prim jobs. Tlie 
command is identical in syniax it» enabling or disiibling, use 
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accept/reject printern 2 une to allow the printer to accept 
or reject jobs. 

Getting information about a printer using the command 
line is also a one liner, though it does not present the 
information in t|uite the way that the Printer Setup Utility 
does. Type the following command, Ipstat —t and a 
complete list of printer statuses, the default destination, and 
the scheduler is shown. 

Going Deeper With Ipadmin 

If you will, the gateway to the CUPS printing system is the 
single command Ipadmin. Until now, [’ve coinpared how it 
can be used with the Menu options in Printer Setup Utility, 
drawing corollaries as appropriate. However, we have not 
examined it extensively. Adding printers is probably the single 
largest headache for a system admini.straton With Ipadmin, 
much of this barrier can l>e overcome without using a Desktop 
Management solution. 

Adding a printer from the command line 

Adding a printer from die command line is probably the 
single most powerful use of Ipadmin. If you wanted to add a 
printer lo a group of computers witli Apple Remote Desktop, 
Ipadmin is a very quick and easy way to do so. Here's the basic 
command to do so: 

Ipadmin -p rayprinter -E -v Ipd://10.0.1,0/queue -m 
iaserjet.ppd 
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Most of this command should look quite familiar, -p 
specifies the printer name. In this case though, the printer 
name can be any name that is de.scnptive. Unlike the Printer 
Setup Utility, the printernaine added with Ipadmin does not 
have to have a form similar to 192_168_1_108. In the 
Printer Setup Utility, this field is the Printer Name, located in 
the Name 8l Location tab. Next we enable the printer with 
the -E option. It is very important that this option is entered 
after the printer option. If it is specified before, Ipadmin 
will attempt io connect to ilie CUPS u.sing encryption. 
Coiitimiing, the most important option is -v. Why? -v 
provides the Uniform Resource Identifier (UKT) for the 
primer. In the above example, Ipd is being used as the 
printer commuiiicatioii protocol. Here is a list of the most 
common device URTs: 

direct pdf700i//distiller 
direct pdf ?00 
network pap 
network socket 
direct bluetooth 

serial fax://dev/cu.Bluetooth Modem 

network epeonpap 

direct epsonflrewire 

network epsontepip 

serial fax 

direct firewire 

network http 

network ipp 

network Ipd 

direct lisb 

network stab 

network mdna 

Determining the device IJRl is one of the trickiest parts of 
adding a printer from the command line. If unsure of the device 
URl, add a test printer with the protcKol desired. Once finished, 
use Ipstat -t to determine the proper form. The last option -m 
.specifies the pjxi file that should lx? used for the printer. If none 
i.s specified, the printer will use the raw driven The raw driver 
is problematic, usually causing print jobs to fail. 

Tlie model option needs closer inspection though, as it 
is not immediately obvious what types of printer models are 
supported. -m use.s only models in the 
/usr/share/cups/model directory. It can also use any 
ppd file at any location on the file system as long as it is a 
file in ppd format. If ihe file is not in 
/usr/share/cups/model, specify the full path with this 
option. But wait, there's more! Mac OS X stores a whole 
slew of drivers in gzipped format. Try adding a ppd file 
stored in this way. Wltal happens? An error is thrown by 
Ipadmin, but the printer is still added! Look at the driver 
though, it is a RAW driver. Nor good. Fortunately, CUPS has 
provided a way around tills, tlie -P option. With this option, 
any gzipped file can be used. Mere's an example command: 

Ipadmin -p prlntername -E -v lpd://l0.0.i.0 -P 

/Librarv/Printer 3 /PFDs/Contents/ResourceB/en.Iproj/Cell\ Laser\ 

Printer\ BlOOcti.gz 


As most of the printer ppd files are gzipped in Tiger, this 
command is prolxildy the mast useful. A couple of other 
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command line options can used to provide a IcKation and 
custom description. The switches are -D for description, and -h 
for location. Tliey are not required, but are useful for 
informational purposes on a client machine. 

Advanced options 

Whai is the nexi step? Adding a printer from tlie command 
line is nice, but Ipadmin has a number of advanced options that 
benefit a system administrator. 

The first option is specifying a quota for the printer. There 
are three types of quotas, kilobyte, page-limit, and period. The 
syntax for all tliree commands is identical, 

Ipadmin -p printername -o job“k-limit“1024 

The three quota options can be used individually or in 
combination. The job-k-limit option sets a limit per kilobyte, 
job-page-limit restricLs the number of pages LliaL can lx: printed, 
and ]ob-quQta“period sets die time interval for quota usage. 
Note that the job-quota-period rime interval is expressed in 
seconds. To enforce quoins fcjr a single day, specify job-c|U{)ta- 
t>eriod^86400. Quotas are applied for each individual user, but 
apply to every user of that printer. As an example, if the quota 
is set to 25 pages, every user will be able to print 25 pages on 
the printer. Users cannot be excluded on an individual basis 
from quota enforcement. 

One other slight change is needed to enforce quotas on 
print queues. Using an editor, open the cupsd.eonf file located 
in /etc/cups. Search for AppieQuotas. The line should l>e 
commented out, uncomment it and restart the cups daemon. 


Unfartunately, die OS X interface does not indicate why printing 
failed, either presenting no dialogue or simply stating that an 
error in printing has happened. 

In addition to (|uoias, users and groups can be allowed or 
denied access to a printer. By now, the command to do tliis 
should look achingly familiar. Once again: 

Ipadmin 'p printername -n deny:username, ^grcmpnaiiie 

'iTds directive sets access controls to print queues on an allow 
deny basis per user. Group name restrictioas use the @ symbol 
before tlie group name. Again, no meaningful feedback is 
provided by the OS X interface. One last piece of information: only 
kx:al users on the machine can l)e denied access, citncntly it does 
not work if die machine is lx)und to a Directory Services system. 

That finally finishes aU of the various options that can be 
controlled using command line tools. With knowledge of all the 
various options, tiiere are numlxir of interesting things that can 
be accomplished using scripts. 

Making it useful 

To make using the command line really useful, how about 
a real world problem? A client machine has been bound to a 
Directory Service. Multiple network users are attempting to 
print, but the queue is stopping for some unknown reason. In 
this case^ a system administrator can use a single command to 
inspect the status of the any printer. Use Ipq to determine if 
jobs are priming, and how many eniries are in the queue. 
Assume that tlie queue has a stuck job. To remove the stuck 
job, send the command cancel jobid. It does the trick 
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quite nicely. If the job id is unknown, add -1 for a complete 
listing of all jobs. 

Pretty quick and dirty, and it solves the immediate problem. 
However, whai if ihe queue has been stuck for some time? The 
printer will immediately begin to process all jobs, often resulting 
in unnecessary and extraneous print jobs. Extending the 
concept, create a logout script. Here’s an example script: 

#l/usr/bin/perl wl 

for (Mpstat -a‘) I 
s/\s, *\n//i 
'cancel a \ 

1 


Tills really short script takes advantage of the CUPS 
command line. Walldng through it, all printers on the machine 
are listed, the trailing return is removed, and all jobs are 
cancelled on all available printers. No more stuck print jobs 
once a user logs out! 

With a knowledge of the command line, the sky is the limit. 
Almost any printer prolileni can lie aditiinistered remotely, u.sing 
your favorite remote administration tool. 

Odds and ends 

One of the problems with adding a jirinter from the 
command line is some functionality is lost, in particular, 
ColonSync profiles are not associated with the printer when 
adding from the command line. With a little fieri magic, a CUFS 
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keyword can be added to tlie printer ppd file that lives in 
/etc/cLips/ppd. Without ftirther delay: 

perl -pi -e •£/\*APP/\‘cupsICCProfile\ 

\/Library\/FrinterB\/DeLl\/Profiles\/DelI\ laserV Fj:iEter\ 

3lOOcn.lcc\n\*APP/' I etc/cups/ppd/rnyprinter.ppd 


This one liner inserts a ColorSync keyword into die printer 
ppd file. Once added, the printer has a ColorSyoc profile 
associated with it. 

Occasionally the debugging infomiation shown in die 
system log file is not sufficient. To crank up the logging 
information, edit the cupsdxonf file. It is initially set to provide 
info level logging. For most purposes dial is sufficient. If not, 
debug and debiig2 can be set in the cupsd.conf file. One 
warning though, the amount of information can be staggering 
when set to del)ug2 level logging. 

One option that has been the bane of many system 
administrators existence is the use of binary printing from 
Phott>.shop. Occasionally users will print a file in binary fonn to 
a printer, spewing pages and pages of one character per page. 
A printer can now be set from the command line to understand 
iiinary printing options. Our good friend, ipadrnin to die rescue! 

Ipadmin -p printername -o protocol=l''BCP 

The printer will now correctly .send binary printing joiis. 
Woohoo! 

The Iasi fun thing that can lie done is accessing die cups 
interface from the local web interface. Open a web browser, 
and enter http ://l oca I host: 631. Most of die functionality in this 
article is available tlirough the web interface. Most often, I use 
it for browsing the CUPS documentation without having to 
access the cups.org website. 

Armed and dangerous 

Almost any task that can he accomplished using Printer 
Setup Utility can also be done with the command line. Only one 
item in Printer Setup cannot be accomjilished easily, adding a 
Desktop Printer. It probably makes sense that thus is the case, 
as desktop printers are a very Mac like functionality. Delving 
into it a little deeper, Printer Setup Utility also create.s a printer 
"app” in /Library/Printers, Ipadmin does nor create this .app file. 
If Deskiop Printers are very irnponant in your environment, the 
command line may not lx? for you. Now get out there, and start 
strutting your new stuff! 
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Ajax on Rails 

Developing Web 2.0 applications 
with the Rails framework 


By Rich Warren 


Introduction 

In ray last article, we built a simple ToDo web 
application, Honey Do. Tliis lirae, we will add fancy new 
Ajax features. YouVe heard of Ajax, right? It is die eye of die 
Web 2.0 buzz-hurricane. Ajax uses JavaScript to dynamically 
update small portions of a page, ‘fhis lets you build 
responsive, interactive web pages. Ajax applications often 
feel like desktop apps. They respond quickly to user actions, 
since they do not need to download a ct>mpletely new page 
every time you dick on a link. Andrew Turner wrote an 
excellent article, “Adding Ajax To A Website", in the January 
2006 issue of MacTech. Plea.se check out that article for an 
overview of this technology. 

Writing an Ajax application often means splitting your 
content-genemtion code into two parts. A typical setup might 
use PHP to communicate with the dambase and build the 
initial page, then use JavaScript for live changes, A single file 
may confiiin three different languages: standard Ifl'ML, PUP, 
and JavaScTipr—as well as references to additional files and 
libraries. As applications Ix^come more complex, these parts 
tend to get tnuddleci. JavaScript calls PHP files, PI IP scripts 
dynamically build JavaScript functions, and everything is 
embedded in the static HTML. 

Rails (and other, siniilarly-minded toolkits), lets you pull 
all the dynamic portions into a siiigle language. RHTML 
templates still mix Ruby and H'FML, but now you create 
99,9% of your Ajax JavaScript using simple Rails helpers. For 
example, in this tutorial, we won’t write a single line of 
JavaScript, Rails keeps us safcly inside the Ruby sandbox. 
'Ihis allows a cleaner separation between presentation 
(HTML), and programming (Ruby). 

Rails has traditionally (if you am say “traditionally” alwui 
anything under 2 years old) had a tight integration witii die 
Prototype and Scriptaculous libraries. Prototype simplifies 
adding Ajiix functions to a frage, while Scripmcultius builds 
visual effects and other goodies on top of die Prototype 
framework. Rails provides a full suite of helper fimctions that 
leverage these iibrarie.s. Many of the helper functions are 
kissing cousins of the regular, htmhgcnerating liclpers. This 
makes adding Ajax to a Rails project nearly transparent. 

But wait, diere*s more gcKid news. Ajax in Rails just got 
easier. Tlie Rails 1.1 release represented a major upgrade. It 


added features across the entire framework, including RJS 
templates—allowing u.s to group a set of dynamic changes, 
dien launch them all as a single aelitrn. In this arliele, we 
will look at both the old-schcxjl Ajax helpers, as well as the 
new RJS features. However, before we jump into the 
wonderful world of Web 2.0, let’s upgrade Rails, 

On die .surface, upgrading rails is stupidly simple. Just 
mn the following command at the command line: 

fludo gm inctflii rails -iaclude-dependencies 

I'hafs it? Well, not quite, lliat just updates the Rails 
library. Applications store several Ruby and JavaScript files 
locally. So, we need to ufidate each application 
individually. Change to the application’s root directory, 
dien use rake to update it* 

cd -'/raile_dev/HoneyDo 
rake railedupdate 

That's it then, right? Yes and no. Everything is 
upgraded—but upgrading is not 2 d ways a good diing. For 
example 'lypo, a popui2ir Rails blogging application, broke. 
Many people found their blogs in shambles after their web 
host upgraded to Riiils i.T Even Honey Do did not escape 
Linscatlied (well fix that in a minute), 

Let this be a warning. Take extra care tiefore 
upgrading any production system. If someone else hosts 
your appliC 2 Kion, you may have no control over when (or 
iD they upgrade ihcir systems. Bui you can protect yourself 
Tile savior is rake, Rails own Swiss Army Knife. Rake 
started as a Ruby version of make (Ruby + make = rake, get 
it?). If youVe ever complied a Unix application, you’re 
probably familiar with die ubiquitous make. Rails, however, 
uses rake for much more than just builds. To see a full list 
of its feature.s, execute the following (again, you must be in 
an application's root directory): 

rake -tasks 

The command we need is rake 
rails: freeze: gems. This makes a copy of the current 
Ralls library and saves it in your application. Your 
application then runs off the kx:al version. Your web host 
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ain cli2inge liieir system WLily-niliy, and your application stays in 
a known state, jost tliought you should know. 

upgrading Honeydo 

Two things broke when we upgraded. Most importanily, the 
delete links no longer delete anytliing. Testing also prodyeed a 
few odd errors (though tite functions work fine wdien checked 
by hand), 'Ibere might be something wrong with scaffold. Given 
the rapid rate of Rails development, die Rails crew will probably 
fix these problems before you can read this, but let’s fix it by 
hand, just to keep us all on the same page. 

Scaffolding c:reate.s seven default actions: :list, :show, 
:new, icreate, :edit, and :destroy/You can override any 
of these by writing your own versions. In HoneyDo, we have 
overridden or replaced all the default actions except rshow 
and :destroy. 

Scaffolding comes in two flavors: dynamic scaffold and 
ScafibldGenerator. Dynamic scaffold aiitoraatkally creates these 
actions (and ilieir associated views) behind the .scenes. You 
won’t find the :show or idestroy actions anywhere in the 
lioneyDo source code. ScaffoklGenerator, on the other hand, 
aciually creates all [he files and ctKle needed by ihe defauli 
actions. You run a script, and it builds the necessary controllers 
and views. Be careful, however. ScaffoldGenerator will 
overwrite existing files. 

To fix the upgrade errtirs, 1 made a copy of the entire 
HoneyDo ti^e. and then ran vScaffoldGenerator on that copy. 

script/generate scaffold item iteni 

,ScaffoldGeneraior created all the default aaions and views. 
We just need to copy the : show and :destroy actions, as well 
as the show view. You also need to comment oui the call to 
dynamic scaffold at tlie top of item_controller. rb, 

LLsting 1: Item Controller 

app/controllers/item_controlienrb 

Add tile foUowing mcth^Kls to the item controiler/fhese tnethotls replace llie 
dytiamie scaffokl hamllers for ilit : destroy and :show aciions. 

class ItemController < AppllcationCoriLroller 
before_fiiter : login_reqiiired: 
tfficaffold litem 
layout 'template' 

def defJtroy 

Item, f1 rid f pa rams [: Id]), destroy 
redlreci_to :act Ion => 'list' 
end 

def show 

^item * Item.find(paramE[:id]] 
end 

Listing 2: Show View 

app/views/item/.show.rhtnil 

Create the £jhow. rhtml templatc.This replaces dynamic scaffold’s show 
view. 

<% for column in Item.content_coluinns %> 

<p) 

column.hiiman_naiiie '!i):</b> <y*=^h 


@item. send (colmim. name) %> 

</p> 

i% end %> 

<%' ‘Edit', ; act ion => 'edit', :id => ®item %} \ 

link_to 'Back'. lactlDii => 'list' %> 

That’s it. All the tests shoiiid run wilhouL any errom. Clearly 
(at Iciist as T write this), dynamic scaffold and ScafibldGenerator 
do not produce ltX)^/o compatible code. In the past, I pi-eferred 
dynamic scaffolding, since it keeps the clutter to a ininirnum. 
However, ScaffcsIdGeneraujr is less opaque—and you can learn 
a lot by examining the code it generates. 

ScaffoldGenerator alsra correctly escapes strings from die 
database. Dynamic .scaffiild still lets hlml lags go through {at 
least die ones I’ve tested). Tliis could be a severe security risk. 
So, for now, 1 would recommend using ScaffoldGenerator to 
build any new applications, 

Ajax Rails Style 

As T mentioned earlier, Rails includes several helper 
functions to create Ajax code. Lets rake a quick look at the 
four general-purpose workhorses: link_to_remote (), 
form_remote_tag(), observe_field() and 

periodically_call_reraote(). There are others, Heck, 
well use some of them. Hut, let’s get our toes wet first, 

link_to_remote () creates a hypertext link. It takes two 
maiti parameters: a string and a hash of options. I'he string 
contains the link’s text, llie option hash generally contains both 
:update => " itemlD" and :url => {;actioii => 

;action_naine) entries. For die : update option, you provide 
the id of an existing tag C<div> tags are usually a safe bet). The 
:url option defines the source of the new htmL Usually, iliis 
will he an aciion or a coniroller/aciion pair. When you click the 
link, Rails calls the named action, and then pours the resulting 
html into the listed tag* 'Hiis replaces the Ug’s ciiment contents; 
everything else on llie page remains unchanged, 

link_to„remote () can also take a second hash of html 
options. In most cases, you can safely ignore this. 

There is one small goldia. In our rails application, the html 
generated by each action is automatically wrapped in the default 
template. While this guarantees that eveiy page has die same 
Icxik and feel, we really don’i want additional copies of the 
[leader and fixiter dropped into the middle of our page. To 
prevent this, add tlie following in the action’s definition: 
render(:layout => false). 

f o rm_ r emo t g_ t a g (} is even simpler. 11 repl a ces the 
form tag 0 helper. Again, you pass in a hash with : update 
and :url values. When you .submit the form, it sends the 
cootenLs of its fields to die :url’s action. Again, the resulting 
html replaces the : update tag’s contents. 

periodically__call_remote () takes an additional 
option : frequency. This will autoinatically call the :url 
action every -.frequency .seconds, pouring the results into the 
; update tag. 

Finally, obHerve_field() is the most complicated. It 
rakes a reference to a form’s field and a frequency. Itien, once 
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every ; frequency seconds, it sends the value of the field to 
the selected action and perforins the update. 


Listing 3= Ajax Sample 
Sample Ajax View 

The followlri^ ex^nipk' demoRsCnitcs calJlng the four b:isie Ajix helpt^rs in a 
typical RHTMl. template, 

<div ld“*test*></div> 

<%- Hrik_to_reovnte( *Ajax Link\ lupdate 
:urt ”> hact I on "> rlitik!) 

<%“ fonii^reiiioLe^tagC :uptlate => :url => faction 

;submit 1} %> 

<1= text_field_taB :mytext %> 

<Tt- observs_field?:inytext * :frequency D*b* 

:update ") 'test*, :url t:action => :observe I) 1) 

<%- periodically call remoteC:frequency -> 10. 

: update 'tent'* ;url I: action => : periodic)) lt> 

<1= end^form_ta& %> 

And that just .sc ratcfics the surface. We haven't even kxiked 
at effecls yet. 

For Our First Trick... 


If the helpers weren't enough^ Rails has several spetaal- 
piirpose Ajax hmetions. For example. Rails can aiitoniaticaily 
create auUxompletc text fields using auto_comple te_for () 
and a little bit of spit and binding twine. Well use this Ui replace 
our user drop-down list with an Ajax-pt)wered text lx)x. 

Tl itr a y t o_c omp 1 e t e_ f o r () nietiiod ta kes a model 
object, an acces.sor niethcxl, and an optional hash. The hash 
contains parameters that Euto_complete_for () then passes 
to the nxxiers find O method. In our case, we will w'antThe 
: login metliod for the :iiser model with no options. By 
default, auto„complete_for () returns the first ten records, 
sorted by tiie metluxl's return value. Tliat should w^ork just fine. 

auLQ_ctjmplete_for ;yser, : login 

Tfie :ne.v and :edit actions no longer need a list of all 
users. Instead, wc just want the current user. Since the Forms are 
changing, :save and :create will need slight adjiisitnenLs. 

Listing 4; Updated Item Controller 

app/con trol lers/i tem_controI ler.rb 

lb enalile the am<H (mii>leie text liox, first call auto_ cDnipleLe_for (), 
llien make ihc following changes to the new C), edit (), save () and 
created methods. 

class IlemCunlrollor < AppUcationController 
betore_fliter : iogiri_rcqulrcd 
auto_coinplete_for :uEer. 

^scaffold :item 
layout 'template' 

def destroy 

Item.flnd (paramslHdJ) - destroy 
tedlrect_Lo jacilou ’^> 'list* 
end 

def show 

@ltem = Itein.find(parainsl:idj) 
end 
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def list 

tuser - ^request.session[:user] 

®UeBj_llsl - &user.todojtems 
tnsine §usec . login.capitalize 

©pages, eitems " paginate(;item, :order_by "> 'priority 
DESCt date*, 

:conditioii£ f'ufier_id ^ 7 \ @user,id}) 
end 

def new 

ftiteni * Item,new 
©user “ ©request.session!:i;ser] 
end 

def edit 

©iteiQ = Ttem.find [©parsDifl [*id'] J 
©user * ©request.session[:user] 
end 

def create 

user ©params ['user' 1 f'login’] 
sender “ ©request,session[aiser] 

©item “ Tten,new(@params['iLeffl'JJ 
©item,sender * sender 

©Ue«,uaer - User . find t: first, : conditions -> [“login - 
iname*, 

hname •> user))) 

©item,date - Time,now 

if ©item,save 

flash [notice] * I ©Item, title [ successfully added 

to" + 

“ #1 ©item, user .login Te To&o list!" 
redlrect_to .action => ’list' 
else 

©users * User,find(:all, torder *> 'login’) 
render action 'new' 
end 
end 

def save 

user “ ©parama['user'1['login'1 
lteiD_hash « ©pararos [' item'T 

©item " Tteta.find(lie0i3flsh['id* 1) 
fl don' t update the sender I 

©Item-user *= User .find(:first, :conditions *’> ["login • 
rname", 

Irname “> user!I) 

# don't update the time! 


if ©item.update_atiributestitem_hash) 

flash!:notice] = “f [©item,title I successfully 
updated I" 

redirect^to iaction *> 'list* 
else 

©users - User.fiiid(:all, border "^> 'iDglu') 
render action 'edit' 
end 
end 

end 

So far, so gtxxl. But, IX'Porf the Ajiix fimclkms will work, we 
neetl to intiutle a[l I lie Prototype and Scriptaculous JavaSeript 
files (see hltp://pr(Hotype.c:onio,ner/ and http;//seripl,an.i[o,us/ 
websites for more information). Not surprisin^^iy^ Rail.s rnciiicie-s 
a helper function for this: javascript_include_tag 
: defaults, Ixl's add this ro the main template. 'Iliai will 
provide tlic Ajax funclion.s U) liI] our views. 

fltylesheet link_tf5g 'scaffold' %> 
javascrlpt_lncltjdc_tag idcfaults %> 

CtltleXX” controller.action_name%></titie> 


In botli the edit and new templates 
(app/views/item/edit,rhtml and new,rhtml 
respectively), look for the colIection_select () helper. 
Thai currently creates the user drop-down menu. 

<td><h>Send To User:</h>C/td> 

<td> 

<%= coll€ctioii_select (ritenif ;user_id* ©users, ^id, 
rlogin)%> 

</td> ■ 

Replace that with the 

text_field_with_aut5_complGtG () helper as shown 
below. Just like auto_cofflplGte„for {), 
text_fleld_with_auto_coinplete () takes a mcKlel and a 
medRxi. Typically, die methtxl is an accessor or a virtual 
accessor. The function cteaies a list of every item in die mtxleL 
It c^lls the accessor on each item, then compares tlie result widi 
the text field's contents. If the text field’s contents are a substring 
of the accessor's value, it is a match. 
text_field_with_auto_complete(} reiiims the first ten 
inalches. In <iur atse, we will search through all the users and 
try to niatcli tlieir login, 

<td><b>Send To IJuer: (yb></td> 

<td> 

<X” teKL_field_with_auto_coiiiplete :uEer* : login %> 

</id> 

That’s it. Stan up MySQL and the WHBrick server, then jxiint 
your browser at I oca I host:3000, login and try to add a new ToDo 
item. Your login should automatically appear in the ''Send To 
User:” field. Iry changing it, and play around witli die auio- 
compleiton limn ions. 

Editing on the Same Page 

Ajax US all alx)ui getting away from the click-on-a-link- 
move-to-a-new-page paradigm. As a gri>s.s oversimplification, 
tliis means doing everything on a single page. So, let’s lei users 
view and edit ToDii items directly on the list view. 

In item_controller*rb, add render(:layout => 
false) if request,xhr? to the end of the :edit and 
: show actions. This keep.s the action from dre.ssing its html in 
the default template when the action is called by an Ajax 
ref|uesi. However, it still functions pro[X‘riy if you access the 
action directly or connect using a .standard link, 

def show 

i ltem = Item* find(paramsl:idj) 
render(;layout => false) if request.xhrt 
end 

Next, in the list view, add a second table. 

<table width-^SOX" aligD“"CEHtef’'> 

CtrXtdXpXdlv id=’scratchpad'X/d!v></p></tdX/tr> 

C/table> 

Only the <div id='scratchpad")'</div> portion is 
important. Our Aptx funcikjns will use it to display the :show 
and : edit html. The rest of the table is just rough formatting. 
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In a real-world project, I would recommend using CSS to format 
the text instead, but For now let's keep things simple. 

Next, we need U) add the actual Ajax calls. Open die row 
partial. Change the link to () hcipcT to 1 lnk_to_remote () 
for Ixitli the show and edit actions. 

Listing 5: Row Partial 

app/vicwsyitem/_row.rhtmI 

Ihe llnk_Lo_rt*m(jte () liclpcr funciion creates a link and the lecjuired 
Ajax JavaScript. Clicking nn the link will call the r show or : edl i action 
lespectively.The returned liiml then replaces the contents of our scratchpad 
<div>. 

<%“ IiTik_to_remote (* Show'. 

:update => 'scratchpad*, 

:url => Uaction *sh(jw*. :i4 -> row.Id t) %> [ 

<%“ link_to_ro»ote(* Kdlt'. 

I iipda te =^> ■ sc ratchpad *, 

:url => I:action 'edit'. :id => row.Id IJ %> j 

lliaPs it—more or less. OF course, we'll want to make a few 
iweaks to the edit atid sliow tern plates. We'll also want to add a 
clear ad ion, to clear the scatchpad. But it works as is. Try it out. 
Bask in the warm g]t>w of Ajax. 

Ok, loo much basking, let's add the clear action. Here we 
tt.se the link_to_furiction() heIpcT. As rhe name implies, 
this creates an html link which tires ofT a JavaScript func tion. In 
our case, we will use Lite visual_ef fectsO helptT to cre;ite 
a fade etTect, 

Rdii br.)th show.rhtml and edit.rhtml. in the show 
view, replace link_to 'Edit' and link to 'Back'. In 


edit, [usL append the code after the table. 

<%-llnh_co_futictloti 'ciDse*. visual, effect (rfade, 

'scratchpad*)%> 

Rade causes our .scratchpad to fade out, eventually 
(tiding it. 1b display new items in our scratchpad, we need 
to make it visible again. Let's add an ^appear effect to the 
original link_to_r emote C) functions. Here the 
: complete option la undies its JavaScTipt function once the 
action has finished. 

Listing 6: Rows With Effects 

app/views/item/_row.rhtml 

The : complete opiion laundics the : appear clfcct once the : show or 
: edi t action conipletes. 

<S“ 1 i£kk_tD_reaio tc (' Sh ow', 
lupdate *Bcratchpad’, 

:url *) hactiou => 'bIiow*, :id => rrtv.idl, 
i ctimplete => visU3l_ef f eet (:appear, * gctalcliped * ]) %> j 

1 lnk_to_retiiote ['Edit.*, 

;update 'ecret^hpad'. 

:uri =) itattian 'edit*, ;id =) row.id I. 
icompleto -> visual_eflect(:appear, 'scratchpad*)) %> | 

As you can see, you can pass the Ajax heljicT fumtioas a wide 
range of options, allowing you to tweak their l^ehavior. I 
RX'onimend browsing tlinnigli I Ik* Rails ckxu mentation. Specifically, 
look at ActionViewHelpers::JavaScrlptHelperj 
ActionViewiiHelpers::PtototypeHelper and 

ActionView::Helpers:tScriptaculousHelper. 
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One Iasi, little tweak. Back in list. rbtml, we want tlie 
scratchpad to start hidden, otherwise, the initial : appear 
effect will not work, 

<div id=‘scratcKpad' styles*display:none*></div> 

Tliat’s it. Take the new interface for a spin. I’d also 
suggest taking a moment to stretcli. Maytx? gel a cup of coffee. 
WeVe plucked all the low^-hanging fiiiit. Tlie next step Ls a 
little more challenging. 

The Next Step 

As you can see, you ean accomplish a lot with the 
built-in Ajax functions. The Rails helpers are particularly 
effective when each action changes just one part of the 
page. Bui, what if you want to make several changes at 
once? Enter RJS templates, 

RJS templates (or more precisely 
JavaScriptGenerator templates) are a new 
addition with Rails 1.1. As you miglit guess, RJS templates 
are views that end with .rjs. Unlike RMTML (and RXML), 
RJS does not provide in.scructions for rendering a new 
page. Instead, these templates contain a list of Ajax 
commands that alter the currently rendered page. 

Wlien an Ajax helixT fires ofl^ an action, the actitJn 
aulomalioally calls the asstxiated RJS lemplale, 'Hie lempiate 
provides access to a JavaScriptGenarator object named 
page. You can use page to insert or remove litml; to replace, 
show or hide page elements; or to eremite visual effects. Check out 
tile dcKUinenlation for 

ActiooView:;Helpers::PrototypeHelper::JavaScrip 
tGenerator: : Genera tor Methods for more infomriiition. 

OK, lets put all this to use. Currently, when we etlit a 
page weYe redisplaying Uie entire page, lasiead. wc would 
like to update only those pans that aaually change. That, 
however, opens a real can of worms—how many changes are 
possible? It seents simple. Obviously, tlie application needs k> 
update the row we just edited. We also want a flash message 
saying the item has changed. But its a little more campliaitetl 
than that. Items are sorted by their priority. If wc change the 
priority, then we need to reorder the rows. If you have more 
than ten items in your ToDo list, then the editerf item could 
shift to a different page, We could try to determine exactly 
which tags need changed, then update them with surgical 
precision—f>ia that would be dlffiailt, probal^ly bug prone, 
and possibly computationally expensive. Instead, let’s replace 
the entire table. 

First, we need to move the table into its own partial, In 
list-rhtml, copy the upper table, and place it in its own 
file, _table, rhtml. 

Listing 7: Table Partial 
app/views/iteni/_table .rhtml 

Move the following code from list. rlitiiil to _table. rhtml. 
Moving the tiibleijeneracian code to its own partial lets us regenerate 
the lable on demand. 


Ctable border='*l*' celispacirjg'“”0px" cellpadding="5pK** 
all gn='" center" id="todo"> 

<tr bgcolor=”cc9^66"'> 

<th>Tteffl!</th> 

<th>Prlorlty</th> 

<th>Date</Lh> 

<th>Sender</th> 

<th>Descriprloa</th> 

<th></th> 

</tr> 

<1- render :psrtlal “> *rqw*, rcol lection Items ^t> 
</table) 


Within the list view, rt^piac'e the table with the tallowing 
code: 

C%= render ip.nrtial “> "table', ilocals “) tilLems => 
Mtemsl %> 


So far, we haveift really changed anything. The page 
should still kK)k and function the same as lx*fore. However, 
moving the table to its own partial, lets us update the table 
whenever we want. 

Next, in the main lempbite add a <div> tag around the flash 
notice a,s shown. This aliom us la change the Hash te>a. We could 
try to update die <p> tag directly; however, the applicadon only 
creates that tag when theie Ls a flash f: notice] message. You 
tan’t change .something that dfX'sn’t exist. Clreating a separate 
<div> guarantees we have a valid taigel. 

<dlv id='flaffhV><%- 

■'<p style”'color : gret?ri'>#( h(©flesh [: notice] J 1 </p>^ 
ir I: notice] 

%></div> 

Normally an Ajax helper will look for a .RJS file whose 
name matches tite action. l.ogicallVi we should then create 
a file named save.rjs that contains the code shown in 
listing 8. 

listing 8: Sample RJS Code 
Sample app/views/i lem/save .rjs 

tinder normal circumstances, Rails wauki call the kdlewing code 
auiamatically whenever an Ajax funciUm culled the curresponding 
: Have action. 

page[iBcratchpfldl*hide 

page.replace 'todo", :partial => "table", :locals => 

I:items => Items I 

page I "row# (©Item, id) ""J , visuai_effect ; highlight, 
istartcolor => '//OOffOO', iduration 5 

page. i:epiace_html "flash", 

"<p style='colortgreen">#[©ttern.11 tie] successfully 
updated K/p>’" 
page[jflasbl-show 

page[iflash]-visual^effeet :pulsate, :queue => 

I:position => "end", 

:scope => 'flash '\ 

pagehflash].visual_effect ;fade. :queue => t:position 
=> ■end', 

;scope => 'flash"I 


Unforrunately, this doesn't work. Our application adds 
the edit form to the page dynamically. The form was not 
part of the original page. I suspect this confuses 
_eclil.rhtm's Ajax helpers. However, there is a way around 
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rhLs problem. We can move the code inu) the controller 
iLsclf. J don't tike this. Ir mixes display code with controller 
code. Bet, you t^oita do wliat you gotta do. 

Open up item_controller.rb, and dtange itie tsave 
action. Listing 9 also includes code to catch saving errons. 

Listing 9: Corrected Save Action 
app/controllers/item_controllerrb 

(Xir :savc action does not correctly call the save.rjs temphite. Insteail, 
move the Ajax changt‘s into the item eoniroilcr.The com roller creates 
a JavaScriptCicneraior ohjea,Wc then use that object to create a 
series of dynamic changes to the current page. 

def save 

user = f*user* ] f'loftin'1 

ItenL-hash • #params [ * item') 

^item = Item, find (itefli_|iasti [‘id'j) 

don't xipdate the sender! 

^item,user User, findC: first ♦ rcondiLloriB 
^ :name"» 

I :naine “> uaerl ]) 
ilf don't update the time! 

if eitem.update_attrlUuie«(Item hash) 
iJser_tiiodei “ §request, sesslon t: user 1 
item_list ^ user_niodel, todo_iLems 
pages. Items * paginate!ritem, :order_by 
'priority DESC, 

date’, r conditions i‘user_i£i = 7 V, 
iiser_iDodei,idJ) 

render ^update do |page| 
page fi scratchpad] Jiidc 

page,replace 'todo', ;parllat "> 'table', tlocals 

-> 

I;iLems ”> itemsi 

page ["row# I 4 ^iteiii,id I "] . visuai„ef feet : highlight, 
rstartcolor 'IfOOffQO'* rduratiun “> 5 

page,replace_htnil 'flash', 

'■<p style*'color: green' >#i^i tern, title I 
successfully updated f</p>’' 

page[:f]ash].show 

page[;flash],viEual_effeet rpulsace, :queue => 

[; posit ion "> ‘end', : scope ”'> 'flash'! 
pageL:flash] , vlSLtal_effect rfade, :queue ”> 

T:position => 'end', :scope => 'flash'] 

end 

else 

ihiser = ^request, session L: User] 
render :update do |page{ 

page,replace„html 'scratchpad', rpartial "*> 

'edit' 

page [ :ErrorExplanation],vlsual_6ffeet ipulsate, 

:duration => 3 
end 
end 
end 

CtckkI enough, hut what does the code do? Well, render 
: update creates a JavaScriptGenerator for the current 
page, and passes it a block, Williin the block, we use the 
page object to make our clianges. You access efemenis using 
their id: page [* id*] or page f: id], 

If the save is successful, we liide the scratchpad, then 
replace the table with new' data generated by the table partial. 
Next, we highligln die clianged row. Specifically we cliange 


the hackgroLind color to green and llien liave it fade back to 
its norniiil color over 5 seconds. 

For the Hash message, we replace the contents of tlie flush 
<div> wiiii die success niess^ige. We dien sliow die message, 
cause it to pulse, and !hcn make it to fade away. ^Hiere are two 
iniponant things to uote here. First, look at die difference 
between page, replace and page , replac e_htn]l, 
page, replace replaces tlte named tag, while 
page, replace_htnil only repbee-S the tag's contents. When 
we replace the (lash <div>, the <div> remains (allowing us 
to send it more message.s later). 

Next, Imk at the flasli message's visual effects. Normally, 
visual effects run in parallel—whicli (5ften means die last effect 
overrides the others. Mere, we are creating a nametl queue, 
and adding the events to the end of the queue. Fffects in a 
queue run secjyenlially. This means the pulsate effect will nin. 
When it nnishes, the fade effer'i mns. 

One last detail, the current code always replaces the table 
with the first page. This is fine when you have less tlian ten 
items, or if you only work on the first page. Otherwise, we 
need to track the current page. 

We want to access the page number in diflerent actions, 
so let’s .save it in the session. Add the following to the end of 
it em__cont roller " s 

BesBidn t :pagej = #pa gee, ctir rent, number 

Now, we need to recover diis value in editO* Again, 
add the following code: 

@page = session[:page] 

<^page is an instance variable, and Rails passes ail the 
controller’.s instance variables to its views. So, within the 
_edit, rhtml panbil, we can access the @pag6 variable 
us shown: 

<%^ for3uremote_tag jurl => l:act;ion “> 'save', cpage 
=> -fflgpage) *'t %> 

This inserts die page number into the parameters that we 
ihen puss to the : save action. Inside saveO^ die 
pagination t) function automatically picks up die page 
number, and produces the correa page. Everydiing else works 
auLo-magically. 

OK, cry if out. Edit an item, and watch the changes. I 
know, 1 know. The clTeas are a bit much. Rut, I hoiie you can 
see the possibilities. 

Up next, adding and deleting ToDo items. I leave those as 
homework problems. You should be able to follow tlie edit 
example alxive. However, pay uttendon u> : destroy. If has 
addidonal complications. Wliai liapt>crLs if you delete the only 
item on a page? 

Cleaning Up The Code 

1 recommend subscribing to the RSS feed for the Ruby 
On Rails lilog (littp://weblog.mbyonniils.org/). A lot of gomi 
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infonnalion Hows through here. Recently, an article poiiiied 
out that the code used by many Rails tutorials and books 
(including my last article) has been deprecated. Specifically, 
yt)u should no longer access die @ pa rams variable directly. 
Instead, access the parameters dirough the paramsO 
method (just delete the This is generally good 
programming advice—use ilic accessor method to access the 
data. This allows you to change how and where the data is 
stored without breaking the application. The same rule 
applies to ©request, ©response, ©session, 
©headers, ©template, ©cookies, and ©flash. In 
addition, @content_fDr_layout should be replaced 
with a simple yield () call. 

1 will not go through all Uiese changes here. But* 1 have 
tried to clean up the sample code. Please forgive me if IVe 
missed the occasional varialile. 

Changing from standard actions to Ajax helpers causes 
some of our lest cases to fail. Again, testing is beyond the 
scope of this article; iiowever, I have updated all the tests 
in the sample code. I have also addeti sample integration 
tests (also new with Rails 1.1). Check oui the sample code 
for more information. 

Ajax Dark Side 

Ajax is impressive, l)ut it has a few problems. First, it 
uses CSS and JavaScri[>i heavily—lioth are famuu.s for 
producing different behavior on differen! brt>wsers. Older 
browsers, in particular, may choke on all the Ajax code. 
The Prototype and Scriptuctilou.s libraries try to isolate you 
from many of these ugly, cross-plat form details* bui 
compatibility problems will occasionally raise their poimy 
lit lie heads. If youTe hniiding a production system* tesi on 
as many different browsers as po.ssible. Also, you migfu 
want to define a fallback command ft)r non-JavaScript 
browsers using formeremote_tag',s :htmi i>plion or 
link_to_remote (]'s :href himl option. See the Rails 
API for more information. 


'fhe second problem is a little subtler, and deserves a lot 
more thought. After you Ajaxify your web page, the back 
button may not work as expected. Hie back button takes you 
back to the previous page. It does not undo any clianges 
made lo the current page. 

Sometimes a functioning Ixick button is more imfxiirTant 
than cool Ajax effects. Think about the application’s 
workflow. Often, you can split an application into logical 
groups. Use standard links to move lietwcen groups (enabling 
the back button), but Ajax techniques widiin a group. 

Finally, Ajax often complicates testing. Hiis is particularly 
true if you are testing the html itself. The Rails testing suite has 
a numlx'r of tools to pull apart html tags and verify the 
presence (or absence) of .specific tags. Unfortunately* most 
Ajax functions return html emlxddcd in JavaScript. Hie tags 
are apparently no longer accessible. However* this might he 
for the best, 1 ITML-level testing is very fragile. It tiften lircaks 
when yfii! change the layout. Your time is probably better 
spent creating more-robust test causes. For example, integration 
tests can handle Ajax functioas just fine. 

Conclusion 

Rails takes niuch of die pain and general ugliness out of 
writing Ajax applications. Ajax adds a laye?r of complexity to 
your application—but Rails effectively manages this 
complexity, making ii almo.st transparent. So, try it. You tniglit 
like 11. 
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NetTfeanri"^ 

SERVER 


Susbshption service now available, running on 
Mac OS X Server. 

Details at; www.netteamserver.com/subscribe 


:.:A • -I 

Connect your people, contacts, relationships, projects, tasks, documents,! 
blogs, web content... your knowledge itself ... and magic follows. 


Most businesses already have this data but in different systems, used by different people, in different 
departments. What a nuisance! NetTeam Server brings it all together, in a web app that everyone can 
use, anywhere. What a difference! 


NetTeam Server 


Features 


NetTeam Server is a business process, content management, collaboration 
and social networking web app for businesses and organizations of any 
size. It offers people, project, task and document management services 
and has a powerful API to support customization. 

The triangle represents NetTeam Server's unique combination of 
functionality for three critical areas: Process, Content and Community. 


NetTeam Server's fundamental capstriicts are 
People, Projects, Tasks and Documents. 

These four are central to all business activities, ^ we 
bring them together in a coherent workspace that 
makes NetTeam Server a true Business Operating 
System. The portal interface can be tailored to match 
client branding and linked systems, and includes five 
Editors (see screenshot) and a modem, AJAX-enhanced, 
configurable user interface. 




User roles determine access privileges and which (if any) 
tools are presented on login. Blogs are used extensively 
to support publishing, information and knowledge 
management. Wikis will be available In a late- 
summer update. 


N^Twim 




NetTeam Server is available for Mac OS X Server, Linux and 
Windows platforms and supports all leading web browsers. 
A Web Services API allows tight IntegraticHi with other 
systems and single sign-on. We also offer a Java mobile 
client which can be tailored to support mobile workforce 
applications. 

NetTeam Server has been successful in deployments 
serving from 10 to 10,000 users and may be installed on a 
server of your choosing, used on a dedicated server we 
provide, or rented as a subscription service (multi- 
company server). 


Consultant, reseller and developer enquiries welcome. 


We’re a good choice even if you only need one of these, but if your 
business operations embrace two or three, you'll love what we can 
do for you. 


• Project Workspace 

- Team/Tasks 

- Workflow 

• Documents 


- Web Content/Site Management 
' Web Document Library 

- Project and Shared Blogs 

- News Editor 


- Users, roles and relationships 

- Simple CRM 

' Social Networking 

- Profile 6 Personal Blogs 
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miniStack 

-ByJordan Ticktin 

Mac mini's use 25'' hard drives, so they are limited on the 
capacity ( I 6 OGB a.s of this writing.). But, the mini is capal)le of 
so much more. So how do you get the mini more storage? 
Simple, You add an exterior liard drive. One example is Newer 
Technology’s miniStack, 

What It Ls 

Newer Technology's miniStack is a hard drive solution for 
your Mac mini, but it also gives you die ability to act as a USB 
and HreWire huh. It has 3 USB ikjfls, 3 FireWire ports, a USB 
uplink port, 2 different types of connettions to the Mac mini, 
and a sectiriiy slot k) secure ihe miniStack to your desk with a 
Kensington MicroSaver Security Cable. 



Figure 1; The miniStack V2 with all of its slots showing. 

Tile miniStack lakes up virtually no space because it fils 
,seamlessly together with (under) your Mae mini. 



Figure 2: Newer Technology's miniStack (with Mac mini on top) 

The power management system is designed to w^ork w'ith 
yt)ur mini, and conserve power. When the miniStack's switch is 
set to on, it will turn on and off whenever your Mac mini does. 

There are two different ways to connect a miniStack to a 
Mac mini: via USB and via FireWire. 'Hie miniStack gives you a 
couple of choices lo optimize for your scenario, 

1. You Hip the connection switch to auto in which aise you will 
connect wiili either USB or 1394 (FireWire) to the Mac mini 
... automaucally dKxising as appropriate; 

2. Or, you flip the switch io 1394a and you connect the 
miniStack to the Mac mini though only FireWire, which will 
make it run faster. 

The miniStack reviewed is the second generation design. In 
version 2, you no longer have an option to manually set ilie fan 
speeds; the miniStack automalgicrally controls die fan to keep the 


unit cool. It also has a large passive heat sink to radiate heat 
away from ihe hard drive. 

To give you more flexibility in your setup, one of the USB 
ptirls and one of the FireWire ports are now on the left side 
instead of the kick. Newer Technology touts the miniStack as 
34% faster than the mini's internal hard drive. 

Depending on what you want, there are a couple of ways 
that you can purcha,sc this prcxluct from Newer I'echnology: 

I. If you want it without a hard drive (no software indudetl): $79,95 

2,lf you want it with a hard drive in it (RMC Retrospect Backup 
and Intech KD Speedtools included): 

BOGB $ 119.00 - 160GB $139.00 
2S(X}B $159.00 - 320 GB $189.00 
400GB $269.99 - 5D0GB $295.99 
750GB $ 499.99 

This produc't has a two year reiiair/rejilacemeni warranty. 

What We Thought 

To put ibis producl to tile test, we diougljt we'd try it as a small 
file server,., iliai is a physiatlfy srmill server that has dime quarters 
of a terabyte of disk space. After running it for several weeks under 
Mac OS X Serw^r, we were ciuite satisfied widj the resulis. 

Obviously, a Mac mini is not a high throughput mac)line, 
nor is an external FireWire drive as efficient as an internal 
drive, but that's no fault of the miniStack. If you need a 
physically small file server, that's relatively quick, can have a 
good amount of disk space, and doesn't need high 
ihroughpui, a mini ctjmbincd with a miniStack is a great 
solution, (Although remember, the mini's 2.5" internal drive 
is not intended kn server use so make sure you back up 
y{)ur boot drive.) 

Or, if you just want a ton of disk space for your mini, this 
is simply a great .solution not just beaiuse it's elegant, but 
because of all the additional pons it has as well. 

For more information on Newer Technology's miniStack, 
visit <http://vwwv.newertech,com/minista^ 
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CompuRover AW Bag 

- By MacTech Review Staff 
For any serious photographer, functionality is the key to 
finding a great bag. But what happens if you are both a 
mkm . photo gra pher , and a heavy lapto p user man y 

of us are . Carrying a SLR setup along with a laptop is a bag 
challenge if you are on the go, parlicularly if you are looking 
for a backpack. 

ITie CompuRover AW bac:kpack from Lowepro is a great 
quality pack that allows you to carry relatively heavy 
etjuipment. Tliis thfee<ompartment backpack is designed to 
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v/Any a digital pro SLR with 
lens attached, 2A additional 
leases, a 17” notebook 
computer, digital accessories, 
and any additional [)ersonal 
items. Better still, because 
the backpack has a waist 
Ix;Il. the weight sits tm your 
hi]:>s, nut on yuui shoulders. 
Carrying 30 pounds of 
camera and cocnp Liter 
equii'Jinent is nut an issue, as we did recently to test the bag, 

Alfliough tlie placement of the camera pocket Ls at the 
Ixjtlom of the I lag, there is enough padding tti protect the 
camera lens il‘ it is facing downwards. While initially the camera 
section seemed to be in a funky position, it Ixfcame clear 
tjuickly in use that this was designed for L|ijicker access ... with 
the o[)titjn of dipping, buckling, or Ixali to close the case. In 
addition, there's a built-in trekker tripod mount for attaching 
tripods up to 10 lbs. 

If you siKmd hours hiking or walking with your equitKncnL 
as we did in testing this hag, then comfort is paramount. We 
found the waist belt is very comfortable, even under weight. In 
fact, the more w'cighu the belter ihe bag felt. The shoulder 
straps are %vell padded. And, of particular cojnfort was the extra 
padding between your back and where the laptop goes, 'the 
only thing that we wished for was to be able to pull some of 
tlie adjustment straps at the top of the shoulder straps even 
tighter, but this is a minor nit. 

There's no doubt that the CompuRover AW is well built, 
sturdy, atid even water-resistant. One of the coolest things that 
we found was it's built in all weather cover wliich acts like a 
“poncho” for your hack pack, securing it with a elastic hand 
around tlie edge. Better yet, die bag was panicularly easy to 
take on and off, even fully loaded. 

In case you are wontiering where [he laptop goes, there’s a 
side-access laptop pocket dial we slid a 17" PowcrOtKik into. 
Being Hat against your back, it was very comfortable, not to 
mention fast lo acces,s at airport sec'tirity checks. 

The backpack's top pocket is smaller than expected for 
such a big bag, but that's the price you pay for all that 
padding around the camera and laptop pockets. The price 
(US$229.99) and slightly excessive weight of the bag arc- 
drawbacks, but well worth it when you realize that you are 
protecting several thousands of dollars in equipment. In fact, 
the padding was so good that w'lien we were caught in the 
recent upgraded airport .security, we felt comfortable 
checking the bag as luggage (although we don^i recommend 
this). 

If you are not going to mostly fill this hag, then it’s overkill, 
luid you'd he better off with a different option. But, if you need 
to carry a laptop and SLR setup, then you need a way to carry 
that weight, and this bag is a great solution. More information 
available from <hTtp://www.lowepro,com> 
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PDF Shrink 4.0 

- By MacTech Review Staff 

M>rl<ing here at MacT'ecIi Mag:i?;ine, in a pR.xluction environment 
tliat deals witli massive image Hies, and anailing each txlier PDF files 
for leview c'an lie a hit daunting. We needed sometliing thn cxiukl 
quickly compress a PDF that did not inducle liiwing to use a utility to 
exanpress it so tliat it would lx: immediately vicnvalile In email ciienis. 
Yet, we wanted suiiicdiiiig tliat would presCTve tlie PDF foniial. Tlus 
Ls wl^n we found PDP Shrink from Apago Inc. 

What is it? 

PDP' Shrink boasts as much as a 90% size reduction of most 
PDF files, but it all depends on what is in the file, and the 
options for compression. Apago posts actual results of 
compression when creating PDFs from a variety of different 
applications. Of course, your mileage may vary. 

PDF Shrink TO includes optional encrypikm of PDP 
content, support for JPEG 2(X)0 image compression, and a 
wizard for creating customized settings, if technical terms like 
compression codec and '‘dots per indr make you s<|uinn and 
scratch your head in fnjstration. 

Since images make up a rather significant part of the size of 
a PDF file, this software t:an modify the rescjluiion and 
compression level of the images to match different requirements. 
Fonts also unnecessarily increase PDF file size, so PDF Shrink 
4.0 has lieen designed with an option lhal allow'.s you to remove 
emliedded base 14 fonts, il required. Another cool option in PDF 
Shrink, is being al>le to delete unused elements such as 
metadata, thumbnails, anti duplicated data. 

A new encryption feature in PDF Shrink 4.0 [protects your 
doamients. Select from several options, such as whether to 
allow changes and printing and content extraction to re^strict use 
or add a password to prevent unauthorized access. All you have 
to do is tell tlie Shrink 4.0 how you intend on using your PDF, 
and it .selects the appropriate settings for you, lliere is also an 
Advanced mode for direedy S|X:cil'ymg your settings. 

To use PDF Slirink, you can choose from a number of 
tlifferenr settings. Fhher drag-and-drop a PDF to the application 
icon or dock, or drag-and-drop to a setting. You can also [>rinl 
through PDF services, create a droplet, or use AppleScript. 

What we think 

One of the tilings we like lx\st ulx>ut PDF Shrink Ls it’s sixed 
and ea,sy to use interface. Being able to just dmg and drop a PDF 
file ont{) your favciriie setiing is incredibly easy and Lime saving. 

If we could change anything, it would be to liave more 
options for image compression, but there are other tools, 
including ones from Apag{) that serve this well. This is a very 
useful prtxlua and well worth the price for nuxst people's use. 

PDF Shrink 4,0 retails at US $35. LJpgrades from earlier 
version.s of PDF Shrink for c'urrent users available for US$14. Visit 
<http://www.apagacorri/upgracle/> to purchase upgrade. However, if 
you Ixiuglit PDF Shrink after Miiy 1, 2006, tlie ujigmde is free. 
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other WorU Computing 

jmb Serving the Mac Universe since 1988 

800.275.4576 \!Z7CZ7^oG5]Q<30QClQSo32)[iII 



Highly Reliable, High-Performance, ^ 
^ Plug & Play-FireWire &USB2 

External Storage Solutions 


vv w w. M ac Sa les.com/stora ge 


owe Mercury EIHe-AL Pro 
.;C: Single Drive & RAID 

FW 800/400 & USB 

Reliable, High-Performance, 
H ig h Ca pacity, A/V Cert ified 
Externa I H D Storag e Sol utio n s. 

• FireWire/USB 

• Plug -and -Play 

• Sleek Design 

^ - Fa St Tra n sfe r Speeds 

• Ultra Portable 

owe Mercury Elite-AL single & RAID 
Professional FireWire/liSB storage HO. 
i -Stand Vertical 

-Stack Horizontal 

£££ -Impact Resistant Design 


owe Mercury EUte Pro XIassic' 


80GBto 500GB from $179.99 


FireWire 400+USB2 


80GB to 500GB from $139.99 


FireWire 800/400 


80GB to SOOGB from 5f49.99 


FireWire 800/400+USe2 


80GB to SOOGB from $93.99 


Backup byl Solu tionsincludeall cables, EMC Retrospect Backup^ 


~ H . ^ 1 ntech HD Speedtools and a re prefonmatted with free 
t AA L . bonus software loaded al I ready to plug and play your 


w w w. MaeSa tes .com /h a rd dr i ves 


WWW. MacSal es .com/e nc losure s 


Reuse Your 

Old Hard Drive 


[laaaMDMEGfls^ 


Use your old drive or purchase a new one to create your own portable 
storage solutions. EASY! Inexpensive! 


NEWl 2.5" SATA Kit 

When you upgrade your 
MacSook/MBPro take 
the old drive or any SATA 
2,5* and create your own 
high performance^ bus 
powered FW800/400tUSB2 
On'The- Go. 

owe OTG SATA $89.99 
M ere uf y O n-Thc - Go SATA 
enclosure upgrade to 
160G8 SATA and turn your 
existing drive in to an easy 
to transport fully bussed 
storage solution. 


Hard Drive Type 


Connection 


3,5" ATA Newertech minlStack Single Drive USB 2.0 + 3-Port USB 2.0 Hub $54.99 
3.S" ATA owe Mercury Elite Pro FW400 FireWire 400 $59.95 

3,5" ATA owe Mercury Elite-AL Pro Triple' FWSOO/400 t USB2 $99.95 

3,5" SATA owe Mercury EIHe-AL 'Quad' eSATA,FWS00,FW400 +USB2 Sf09.9J 

3.5" SATA owe Mercury EISte-Al Dual SATA ESATA $79.95 


Internal SATA HD Upgrade Solution 
MacBook & Mac Book Pro *160GB 
EMC Backup irtcluded, now up to 160 GB, 
only $289! 


FWg(}0/400 + USB2 


eSATA Two to Five Bay Tray' Solutions by Sonnet and Firmtek froin $169. 


w w w.MacS ales, com/co rjt rollers 


Hard Disk Controller Cards can 
Bulk up you Computer by giving 
it higher capacil^. 


For iMacs, eMacs Si PowerMacs 

3,5" Plug and P lay 40GB to SOOGB from $47.95 

For PowerBooks,ibooks St Mac Minis 


2.5 ATA Drives 40GBtoT60GB from $59,00 


External Storage Solutions (FireWire & USB) 


Internal Hard Drives 


Do-It-Yourself Enclosure Kits 


\Ejndosures for Every Budget! Options with FireWire BOO, F W4Q0, USB2, eSATA 


Control ler Cards 


W® :Drive5 for of/ter Macs 


owe Mercury Elite*AL Pro Soiutiori$ 

FireWire 400+USB2 

80GB to 750GB 

from SH4.99 

FireWire 800/400 

80GB to 750GB 

from $129.99 

FireWire S0O/4O0+USB2 

80G6to 7S0GB 

from $)39.99 

New! Quad Interface 
eSATA, FW400, FW800, USB 

2S0GB to 750GB 

fromSl99.99 

loWCMercuryme-AL Pro FW BOO PAID Soiutiom 

Pro 800 Performance RAID 

160GB to 1,STB 

from $209.99 

Pro BOO RAID 1 Mirrored Backup 

250GB to 7S0GB 

from $379.99 

Pro 800 RAID 0+1 Stripe+Mirror 

SOOGB to 1.5TB 

from $649.99 


Mac&ook pro md Mac Book Hard Drives I 
5ATA Drivesup td J60GB I 


7200RPM 

100GB 

$199.99 

Seagate 

5400RPM 

120GB 

$169.99 

S400RPM 

160 GB 

$279.00 

Hitachi 

7200aPM 

IQOGB 

$169.99 

5400RPM 

160GB 

$259.00 

Western 

Digital 

54O0RPM 

120GB 

$139.99 


US82 

SDGB to SOOGB 

from S95.99 

owe Mercury On-The-Go 

TotaHy Bus-Pa werftt Pocket SizedSoiuiion 

FireWire &00/400+USB2 

40GB to 160GB 

from SI39.99 

FireWire400 + USB2 

40GB to 160GB 

fromS«4.99 

FireWire 400 

40GB to T20GB 

from 51)5.99 

USB2 

40GB to 120GB 

from $95.99 

owe Neptune -Value Done Right 


Hard Disk Cqntrofler Cards j 

0W€ 

2-Channe! SATA/eSATA {Int/Ext) PCI/PCI-X 549.95 


2-Channel SATA Internal PCI/PCE-X 

$54.99 


4 -Channel SATA Internal PCI/PCFX 

$57.99 

nm 

Up to 8 Channel PCl/PCI-X/PCI-Ex press 

from 

579.99 

FirmTek Up to 4 channel PCI/PCI K/PCI Express 

from 

559.95 

FirmTek 2-CharTnel SATA PCIE34 for MacBook 

$119.99 


Fast Speed! High Capacity! Low Price! \ 

i—- 

mmiStack VI 

(built with additional FireWire Ports. 4 Added USa 2.0 High Speed Forts/ 


FireWire 800/400+0512 BOGBto 7S0GB from $124.99 
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y More Memory = Faster Mac 

The RIGHT Memory for 
the New Apple Pro Mac Quad Xeon Towers 

owe Memory for Mac Pro Quad Xeon fully meets 
Apple's specifications including important thermaf 
requirements. Modules must be installed in pairs and 
are sold in matched kit sets. DDR2 667 MHZ ECC Fully 
Suffered SDRAM 


WWW. Macs a I es .co m/m e mory 


Memory Upgrades for Every Intel Mac 

-in Stock, Ready to Ship, Great Prices! Call 800 27% 4576 0/ V/S/f WWW. 
MacSaies.(:on}/M^n^Ofy ond iJse ouf CJn/fne Gwde 


The Newest Accessories 
Maximize Your Mac 

Aviator La| 

by Keynamicsl 

N E W! * Take A Stan d' Anywhere! A ro und Town or A ro u nd the World I 
Super Strong ■ Super Stable ■ Stores Flat ■ 9 oz. onty 5 1 9.S0 I 


w w w. M a c Salesmen m /accesso nes 


w w w.M a eSaJe s.c o m/ N e werTec h 


/l/crPlDMwr'Laptop Batteries 

/>> riB uj B r- t:Bc:l-inci1ogyi 

The Highest Capacity Replacement Batteries 
for Apple Computers PERIOD! 

Up to 62% More Capacity 


|) r^rr^Rain Design i360" 

.tnitootf fiwn A Turntable for your iWlac GS 17’^and 20* S39.00 


Village Tronic VTBook 

This OVIG ra phlcs Cards ena bles you to add another l ^ (tej;. 
^ CRT or n at Panel Display to your Fowe rbook 1 f ' 5 M j. ; 

SJ«.99 


iLugger iMac cases 

for the IMac GS or lor Mac mini and/or up to 30* LCD Display 
5 color combinations starting at $95.00 j 




G4 'Aluminum' 17" display 60 to 67 from 5129.95 

G3 iBooks 12"* 12.r display 45,5 to 55.5 from $99.95 

G3 Of G4 iBook 14" display S9 to 74 from $99.95 

iBook 'ClamSheir 65 to 71 from $109.99 


Network Adapters 




iMacBook/Pro NuPower MaxCapacity batteries will be available soon. 


Sonnet Presto 10/100/1000 Gigabit Ethernet PCI S8S.99 


PRAM Batteries 

fs your Mat forgetting what time it is? 
owe PRAM batteries starting at $4,99 


o> n e LiJ e r*1:eizti nol a gyi 

NuPower^ 

iPod Replacement Batteries 


Wireless Mouse 

Logitech Cordless'Click' 3-Buttorv-i- Scroll wheel 
Optical Mouse for USB 
SPEclAl ST5,99 


Easy to Install Tools Included + 
Online Installation Videos, 

Get up to 7B% more capacity & 
20+ Hours Runtime! 


Laptop Screen Protectors 

Protect you r scree nl There's a n OWC La ptop 
Screen Protector (LSP) product for your Mac, 
PowerBook G4 17" $17,99 PowerBook G4 15" $17.95 
PowerBook Gi 15" $14,99 iBook/PowerBook G4 12" $15,95 

Till'owe iSharppreclslqit nil, glgveufi leather puntertor^ tlu( prpvpnl potentially 
pprmiincnl m,ni; witkh tdii [Kcurfrani ihe iraf kpad .uid keyhp^rd while yitur cloinl. 


From Mac Pro's to iPod's 
owe has the hardware to 
Maximize Your Mac 
WWW, Ma c Sa les .CO m 


Memory Upgrades 


Laptop and iPod Batteries 


l/f^odRep/aceme/Ttfiofter/es 1 

Model 

mAH 

Price 

1 8t 2 Generation 

1800 

$7.99 

2100 

$19.99 


2200 

$29,99 

3 Generation 

850 

$19.99 

4 'Generation 

850 

$19.99 

1350 

$29.95 

iPod mini 

600 

$24.95 


iNmerT^hiotitonBatt&riei I 

Model 

Watt'Hour 

Price 

G3 PowerBooks lombard' 

68 to 81 

from $135.99 

G3 PowerBooks 'Pisrno' 2000 

68 to 81 

from SJ35.99 

G3 PowerBooks “WallStreet' 

65 

5129.99 

G4 'Titanium' 

65 to 74 

from 5729.99 

G4'Aluminum' 12" display 

53.3 to 55,5 

from 5709.99 


\ Memory Uparades for Other MACS I 

Mac mini Intel (Core Solo/Core Duo) 

512MB to 4GB 

from 5'79.CW 

MacBook & MacBook Pro Intel Core Duo 

S12MBto2GB 

from 556.95 

iMac Intel (Core Solo/Core Duo} 

512MB to 2GB 

from 556,95 

1B4 Pin DIMM 

256MB to 2GB 

from5«S9 

G5 'Dual Core’ 

1GB to 4GB 

from $97.99 

G4 Aluminum Laptop Family 

512MB to 2GB 

from 5479? 

G3 PowerBook 

128MB to S12MB from 577.99 

G4 iBook 

512MB to 1GB 

from $54.95 

G3 iBook 

128MB CO 512MB from $?7.99 

iMacG5 

512MB to 2GB 

from 55799 

iMacG4 

256MB to 1GB 

from 526.99 

IMacG3 

128MBto5T2MB from $T7.99 

168 Pin DIMM 

128MBto 512MB from5J5.99 


iMdcPto/QuaifColreTB-OJMAfl 1 

Add Memory in Sets unsing TGb FB-DIMM 

26S Matched Set (1G8 Modules x 2} 

5499.00 

4GB Matched Set 0 GB Modules x 4) 

5979.00 

6GB Matched Set (1GB Modules x 6} 

5746700 

8GB Matched Set (IGB Modules x 8} 

$1949.00 

Add Memory in Sets unsing 2Gb FB-DIMM 

4GB Matched Set (2GB Modules x 2) 

$1,049.00 

SGB Matched Set (2GB Modules n 4^ 

$2,079.00 

12G8 Matched Set (2GB Modules x 6) 

$3,099.00 

16G6 Matched Set (2GB Modules x 8) 

$3,999.00 


www.MacSales.com * 800.275.4576 

Ftbees, ijieriAfatiMU aird awailabllltyaresubjefTtD withautnetke.ltemifeturAedwithla 3Q days aay l9«iabj|ecttoareitDckln|lee. OtkerWeHd Campullnii 

Ms r^mrnvrUl b«a(»pttd ndthaut Merchandise Au*herlii«iwi Fiumber lODdCaurtaidds Dr.^Wooilitech, IL61M98 
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How to Stop 

Racing the Clock 


□Work Longer? DWork Harder? 

^Energize Your Mac! 


We know your day keeps getting longer and longer. With every release of software, your Mac Is 
bogged down even more. With every click, there's a pause. You find yourself working longer, working harder. 
A fester Mac means that you can work fester, not harder - be more productive! 

Let the original Mac Performance Shop help. Daystar has been creating Mac speed for over 16 years. 
Whether your bottleneck is storage, connectivity or just raw CPU speed, we deliver the performance you 
need, where you need it. 



CPU Upgrades for Raw Speed. We upgrade any Power Macintosh, 
any iMac Flat Panel, any PowerBook G3 and some PowerBook G4s. 

Fast and Large Storage for Real-Time Video. Our TURBOS<47>4 

solutions can make your drives perform like RAM. Projects open in a 
flash and edit in real-time. 

Extreme Wireless. Wireless is great, unless you're getting slow 
transfers. Even Airport Extreme's are slow when the signal is weak. 
Daystar can boost your signals and energize your wireless network. 

But, if You Really need a G5? Daystar is the only Mac Performance 
Manufacturer that is also an Apple Authorized Reseller. Not only can 
you trade-in your system for the latest and greatest... but the Daystar 
Pro's can upgrade it for maximum performance! 

Call 877-439-8646 and beat the clock. 

Authorized Reseller 


VVWiVVC* TECWWOtOCY 


Daystar Technology - Your Macintosh Performance Shop 

5018 Bristol Industrial Way, #202, Buford, GA 30518 USA 
Toll Free: 877-439-8646 or 770-614-5400 


Daysta r-Tech .com 


Daystar-Forum.com 


Da y sta r-Sto re. com 
















THINGS MADE IN CHINA 


COMPRESSED BY 


STUFFIT DELUXE 
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